di_lnode_private_get(3devinfo)

1di_node_private_set(3DDEeVvIiNcFeO)Information Library Fudnic_tnioodnes_private_set(3DEVINFO)
2
3
4

NAME

6       di_node_private_set,      di_node_private_get,     di_path_private_set,
7       di_path_private_get,    di_minor_private_set,     di_minor_private_get,
8       di_link_private_set,     di_link_private_get,     di_lnode_private_set,
9       di_lnode_private_get - manipulate libdevinfo user traversal pointers
10

SYNOPSIS

12       cc [ flag... ] file... -ldevinfo [ library... ]
13       #include <libdevinfo.h>
14
15       void di_node_private_set(di_node_t node, void *data);
16
17
18       void *di_node_private_get(di_node_t node);
19
20
21       void di_path_private_set(di_path_t path, void *data);
22
23
24       void *di_path_private_get(di_path_t path);
25
26
27       void di_minor_private_set(di_minor_t minor, void *data);
28
29
30       void *di_minor_private_get(di_minor_t minor);
31
32
33       void di_link_private_set(di_link_t link, void *data);
34
35
36       void *di_link_private_get(di_link_t link);
37
38
39       void di_lnode_private_set(di_lnode_t lnode, void *data);
40
41
42       void *di_lnode_private_get(di_lnode_t lnode);
43
44

PARAMETERS

46       node     The handle to a devinfo node in a di_init(3DEVINFO) snapshot.
47
48
49       path     The handle to a path node in a snapshot.
50
51
52       minor    The handle to a minor node in a snapshot.
53
54
55       link     The handle to a link in a snapshot.
56
57
58       lnode    The handle to an lnode in a snapshot.
59
60
61       data     A pointer to caller-specific data.
62
63

DESCRIPTION

65       The di_node_private_set() function allows a caller to associate caller-
66       specific  data  pointed to by data with a devinfo node, thereby facili‐
67       tating traversal of devinfo nodes in the snapshot.
68
69
70       The di_node_private_get() function allows a caller to retrieve  a  data
71       pointer  that  was associated with a devinfo node obtained by a call to
72       di_node_private_set().
73
74
75       The di_path_private_set() function allows a caller to associate caller-
76       specific  data  pointed  to  by  data with a devinfo path node, thereby
77       facilitating traversal of path nodes in the snapshot.
78
79
80       The  di_path_private_get()function allows a caller to retrieve  a  data
81       pointer  that  was  associated  with  a path node obtained by a call to
82       di_path_private_set().
83
84
85       The di_minor_private_set() function allows a caller to associate  call‐
86       er-specific  data  pointed  to  by  data with a minor node specified by
87       minor, thereby facilitating traversal of minor nodes in the snapshot.
88
89
90       The di_minor_private_get() function allows a caller to retrieve a  data
91       pointer  that  was  associated  with a minor node obtained by a call to
92       di_minor_private_set().
93
94
95       The di_link_private_set() function allows a caller to associate caller-
96       specific data pointed to by data with a link, thereby facilitating tra‐
97       versal of links in the snapshot.
98
99
100       The di_link_private_get() function allows a caller to retrieve  a  data
101       pointer  that  was  associated  with  a  link  obtained  by  a  call to
102       di_link_private_set().
103
104
105       The di_lnode_private_set() function allows a caller to associate  call‐
106       er-specific  data  pointed to by data with an lnode specified by lnode,
107       thereby facilitating traversal of lnodes in the snapshot.
108
109
110       The di_lnode_private_get() function allows a caller to retrieve a  data
111       pointer  that  was  associated with an lnode by a call to di_lnode_pri‐
112       vate_set().
113
114
115       These functions do not perform any type of locking. It  is  up  to  the
116       caller to satisfy any locking needs.
117

RETURN VALUES

119       The    di_node_private_set(),    di_path_private_set(),   di_minor_pri‐
120       vate_set(), di_link_private_set(), and di_lnode_private_set() functions
121       do not return values.
122
123
124       The    di_node_private_get(),    di_path_private_get(),   di_minor_pri‐
125       vate_get(), di_link_private_get(), and di_lnode_private_get() functions
126       return  a  pointer  to  caller-specific  data that was initialized with
127       their corresponding *_set() function. If no  caller-specific  data  was
128       assigned with a *_set() function, the results are undefined.
129

ERRORS

131       No errors are defined.
132

ATTRIBUTES

134       See attributes(5) for descriptions of the following attributes:
135
136
137
138
139       ┌─────────────────────────────┬─────────────────────────────┐
140       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
141       ├─────────────────────────────┼─────────────────────────────┤
142       │Interface Stability          │Committed                    │
143       ├─────────────────────────────┼─────────────────────────────┤
144       │MT-Level                     │Safe                         │
145       └─────────────────────────────┴─────────────────────────────┘
146