1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2014 Garrett D'Amore <garrett@damore.org>
*
* Copyright (c) 1992, 2010, Oracle and/or its affiliates. All rights reserved.
*/
#ifndef _SYS_INSTANCE_H
#define _SYS_INSTANCE_H
/*
* Instance number assignment data structures
*/
#include <sys/types.h>
#include <sys/param.h>
#include <sys/dditypes.h>
#include <sys/list.h>
#ifdef __cplusplus
extern "C" {
#endif
#define INSTANCE_FILE "/etc/path_to_inst"
#define INSTANCE_FILE_SUFFIX ".old"
#if defined(_KERNEL) || defined(_KMEMUSER)
/*
* The form of a node; These form a tree that is parallel to the
* dev_info tree, but always fully populated. The tree is rooted in
* the in_softstate struct (e_ddi_inst_state.ins_root).
*
* Each node has one or more in_drv entries hanging from it.
* (It will have more than one if it has been driven by more than one driver
* over its lifetime. This can happen due to a generic name
* or to a "compatible" name giving a more specific driver).
*/
typedef struct in_node {
char *in_node_name; /* devi_node_name of this node */
char *in_unit_addr; /* address part of name */
struct in_node *in_child; /* children of this node */
struct in_node *in_sibling; /* "peers" of this node */
struct in_drv *in_drivers; /* drivers bound to this node */
struct in_node *in_parent; /* parent of this node */
dev_info_t *in_devi; /* corresponding devinfo */
} in_node_t;
typedef struct in_drv {
char *ind_driver_name; /* canonical name of driver */
int ind_instance; /* current instance number */
int ind_state; /* see below */
/*
* The following field is used to link instance numbers for the
* same driver off of devnamesp or in_no_major or in_no_instance
*/
struct in_drv *ind_next; /* next for this driver */
struct in_drv *ind_next_drv; /* next driver this node */
struct in_node *ind_node; /* node that these hang on */
} in_drv_t;
/*
* Values for in_state
*/
#define IN_PROVISIONAL 0x1 /* provisional instance number assigned */
#define IN_PERMANENT 0x2 /* instance number has been confirmed */
#define IN_UNKNOWN 0x3 /* instance number not yet assigned */
#define IN_BORROWED 0x4 /* instance number from alias */
/*
* Guard for path to instance file
*/
#define PTI_GUARD "#\n#\tCaution! This file contains critical kernel state\n#\n"
/*
* special value for dn_instance
*/
#define IN_SEARCHME (-1)
#endif /* defined(_KERNEL) || defined(_KMEMUSER) */
#ifdef _KERNEL
void e_ddi_instance_init(void);
uint_t e_ddi_assign_instance(dev_info_t *dip);
void e_ddi_keep_instance(dev_info_t *dip);
void e_ddi_free_instance(dev_info_t *dip, char *addr);
int e_ddi_instance_majorinstance_to_path(major_t major,
uint_t instance, char *path);
void e_ddi_unorphan_instance_nos(void);
void e_ddi_enter_instance(void);
void e_ddi_exit_instance(void);
in_node_t *e_ddi_instance_root(void);
int e_ddi_instance_is_clean(void);
void e_ddi_instance_set_clean(void);
/* Platform instance override functions */
uint_t impl_assign_instance(dev_info_t *dip);
int impl_keep_instance(dev_info_t *dip);
int impl_free_instance(dev_info_t *dip);
/* walk the instance tree */
int e_ddi_walk_instances(int (*)(const char *,
in_node_t *, in_drv_t *, void *), void *);
/* for DDI-MP */
in_node_t *e_ddi_path_to_instance(char *path);
void e_ddi_borrow_instance(dev_info_t *cdip, in_node_t *cnp);
void e_ddi_return_instance(dev_info_t *cdip, char *addr, in_node_t *cnp);
/* return values from e_ddi_walk_instances callback */
#define INST_WALK_CONTINUE 0
#define INST_WALK_TERMINATE 1
#else /* _KERNEL */
extern int inst_sync(char *pathname, int flags);
#endif /* _KERNEL */
#define INST_SYNC_IF_REQUIRED 0
#define INST_SYNC_ALWAYS 1
#ifdef __cplusplus
}
#endif
#endif /* _SYS_INSTANCE_H */
|
