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
150
151
152
153
154
|
/*
* 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 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
/*
* Copyright 2020 Joyent, Inc.
*/
#ifndef _TOPO_TREE_H
#define _TOPO_TREE_H
#include <fm/topo_mod.h>
#include <libipmi.h>
#include <topo_list.h>
#include <topo_prop.h>
#include <topo_method.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef struct topo_modhash topo_modhash_t;
typedef struct topo_range {
topo_instance_t tr_min;
topo_instance_t tr_max;
} topo_range_t;
typedef struct topo_nodehash {
topo_list_t th_list; /* next/prev pointers */
tnode_t **th_nodearr; /* node array */
uint_t th_arrlen; /* size of node array */
char *th_name; /* name for all nodes in this hash */
topo_mod_t *th_enum; /* enumerator module */
topo_range_t th_range; /* instance ranges for nodes */
} topo_nodehash_t;
struct topo_node {
pthread_mutex_t tn_lock; /* lock protecting members */
char *tn_name; /* Node name */
topo_instance_t tn_instance; /* Node instance */
int tn_state; /* node state (see below) */
int tn_fflags; /* fmri flags (see libtopo.h) */
struct topo_node *tn_parent; /* Node parent */
topo_nodehash_t *tn_phash; /* parent hash bucket for this node */
topo_hdl_t *tn_hdl; /* topo handle pointer */
topo_mod_t *tn_enum; /* Enumerator module */
topo_list_t tn_children; /* hash table of child nodes */
topo_list_t tn_pgroups; /* Property group list */
topo_list_t tn_methods; /* Registered method list */
void *tn_priv; /* Private enumerator data */
int tn_refs; /* node reference count */
topo_vertex_t *tn_vtx; /* NULL for tree topologies */
};
#define TOPO_NODE_INIT 0x0001
#define TOPO_NODE_ROOT 0x0002
#define TOPO_NODE_BOUND 0x0004
#define TOPO_NODE_LINKED 0x0008
typedef struct topo_tree {
topo_list_t tt_list; /* next/prev pointers */
char *tt_scheme; /* scheme name */
topo_mod_t *tt_mod; /* builtin enumerator mod */
struct topo_node *tt_root; /* root node */
topo_walk_t *tt_walk; /* private walker */
} ttree_t;
struct topo_walk {
struct topo_hdl *tw_thp; /* Topo handle pointer */
struct topo_node *tw_root; /* Root node of current walk */
struct topo_node *tw_node; /* Current walker node */
int (*tw_cb)(); /* Walker callback function */
void *tw_pdata; /* Private callback data */
topo_mod_t *tw_mod; /* module if walking from plugin */
};
typedef struct topo_alloc {
int ta_flags;
nv_alloc_t ta_nva;
nv_alloc_ops_t ta_nvops;
void *(*ta_alloc)(size_t, int);
void *(*ta_zalloc)(size_t, int);
void (*ta_free)(void *, size_t);
} topo_alloc_t;
struct topo_hdl {
pthread_mutex_t th_lock; /* lock protecting hdl */
char *th_uuid; /* uuid of snapshot */
char *th_rootdir; /* Root directory of plugin paths */
char *th_platform; /* platform name */
char *th_isa; /* isa name */
char *th_machine; /* machine name */
char *th_product; /* product name */
di_node_t th_di; /* handle to root of devinfo tree */
di_prom_handle_t th_pi; /* handle to root of prom tree */
topo_modhash_t *th_modhash; /* Module hash */
topo_list_t th_trees; /* Scheme-specific topo tree list */
topo_list_t th_digraphs; /* Scheme-specific topo digraph list */
topo_alloc_t *th_alloc; /* allocators */
int th_errno; /* errno */
int th_debug; /* Debug mask */
int th_dbout; /* Debug channel */
ipmi_handle_t *th_ipmi; /* IPMI handle */
pthread_mutex_t th_ipmi_lock; /* IPMI lock */
smbios_hdl_t *th_smbios; /* SMBIOS handle */
pcidb_hdl_t *th_pcidb; /* libpcidb handle */
};
#define TOPO_UUID_SIZE 37 /* libuuid limit + 1 */
extern ttree_t *topo_tree_create(topo_hdl_t *, topo_mod_t *, const char *);
extern void topo_tree_destroy(ttree_t *);
extern int topo_tree_enum_all(topo_hdl_t *);
extern void topo_node_lock(tnode_t *);
extern void topo_node_unlock(tnode_t *);
extern void topo_node_hold(tnode_t *);
extern void topo_node_rele(tnode_t *);
extern tnode_t *topo_node_lookup(tnode_t *, const char *, topo_instance_t);
extern int topo_node_hash(topo_nodehash_t *, topo_instance_t);
extern int topo_walk_bottomup(topo_walk_t *, int);
extern topo_walk_t *topo_node_walk_init(topo_hdl_t *, topo_mod_t *, tnode_t *,
topo_walk_cb_t, void *, int *);
#ifdef __cplusplus
}
#endif
#endif /* _TOPO_TREE_H */
|
