DI_NODE_PRIVATE_SET(3DEVINFO) Device Information Library Functions
di_node_private_set, di_node_private_get, di_path_private_set,
di_path_private_get, di_minor_private_set, di_minor_private_get,
di_link_private_set, di_link_private_get, di_lnode_private_set,
di_lnode_private_get - manipulate libdevinfo user traversal pointers
cc [ flag... ] file... -ldevinfo [ library... ]
#include <libdevinfo.h>
void di_node_private_set(di_node_t node, void *data);
void *di_node_private_get(di_node_t node);
void di_path_private_set(di_path_t path, void *data);
void *di_path_private_get(di_path_t path);
void di_minor_private_set(di_minor_t minor, void *data);
void *di_minor_private_get(di_minor_t minor);
void di_link_private_set(di_link_t link, void *data);
void *di_link_private_get(di_link_t link);
void di_lnode_private_set(di_lnode_t lnode, void *data);
void *di_lnode_private_get(di_lnode_t lnode);
node
The handle to a devinfo node in a di_init(3DEVINFO)
snapshot.
path
The handle to a path node in a snapshot.
minor
The handle to a minor node in a snapshot.
link
The handle to a link in a snapshot.
lnode
The handle to an lnode in a snapshot.
data
A pointer to caller-specific data.
The di_node_private_set() function allows a caller to associate
caller-specific data pointed to by data with a devinfo node, thereby
facilitating traversal of devinfo nodes in the snapshot.
The di_node_private_get() function allows a caller to retrieve a data
pointer that was associated with a devinfo node obtained by a call to
di_node_private_set().
The di_path_private_set() function allows a caller to associate
caller-specific data pointed to by data with a devinfo path node,
thereby facilitating traversal of path nodes in the snapshot.
The di_path_private_get()function allows a caller to retrieve a data
pointer that was associated with a path node obtained by a call to
di_path_private_set().
The di_minor_private_set() function allows a caller to associate
caller-specific data pointed to by data with a minor node specified
by minor, thereby facilitating traversal of minor nodes in the
snapshot.
The di_minor_private_get() function allows a caller to retrieve a
data pointer that was associated with a minor node obtained by a call
to di_minor_private_set().
The di_link_private_set() function allows a caller to associate
caller-specific data pointed to by data with a link, thereby
facilitating traversal of links in the snapshot.
The di_link_private_get() function allows a caller to retrieve a data
pointer that was associated with a link obtained by a call to
di_link_private_set().
The di_lnode_private_set() function allows a caller to associate
caller-specific data pointed to by data with an lnode specified by
lnode, thereby facilitating traversal of lnodes in the snapshot.
The di_lnode_private_get() function allows a caller to retrieve a
data pointer that was associated with an lnode by a call to
di_lnode_private_set().
These functions do not perform any type of locking. It is up to the
caller to satisfy any locking needs.
The di_node_private_set(), di_path_private_set(),
di_minor_private_set(), di_link_private_set(), and
di_lnode_private_set() functions do not return values.
The di_node_private_get(), di_path_private_get(),
di_minor_private_get(), di_link_private_get(), and
di_lnode_private_get() functions return a pointer to caller-specific
data that was initialized with their corresponding *_set() function.
If no caller-specific data was assigned with a *_set() function, the
results are undefined.
No errors are defined.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
di_init(3DEVINFO), libdevinfo(3LIB), attributes(7)
May 15, 2008 DI_NODE_PRIVATE_SET(3DEVINFO)
NAME
di_node_private_set, di_node_private_get, di_path_private_set,
di_path_private_get, di_minor_private_set, di_minor_private_get,
di_link_private_set, di_link_private_get, di_lnode_private_set,
di_lnode_private_get - manipulate libdevinfo user traversal pointers
SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ]
#include <libdevinfo.h>
void di_node_private_set(di_node_t node, void *data);
void *di_node_private_get(di_node_t node);
void di_path_private_set(di_path_t path, void *data);
void *di_path_private_get(di_path_t path);
void di_minor_private_set(di_minor_t minor, void *data);
void *di_minor_private_get(di_minor_t minor);
void di_link_private_set(di_link_t link, void *data);
void *di_link_private_get(di_link_t link);
void di_lnode_private_set(di_lnode_t lnode, void *data);
void *di_lnode_private_get(di_lnode_t lnode);
PARAMETERS
node
The handle to a devinfo node in a di_init(3DEVINFO)
snapshot.
path
The handle to a path node in a snapshot.
minor
The handle to a minor node in a snapshot.
link
The handle to a link in a snapshot.
lnode
The handle to an lnode in a snapshot.
data
A pointer to caller-specific data.
DESCRIPTION
The di_node_private_set() function allows a caller to associate
caller-specific data pointed to by data with a devinfo node, thereby
facilitating traversal of devinfo nodes in the snapshot.
The di_node_private_get() function allows a caller to retrieve a data
pointer that was associated with a devinfo node obtained by a call to
di_node_private_set().
The di_path_private_set() function allows a caller to associate
caller-specific data pointed to by data with a devinfo path node,
thereby facilitating traversal of path nodes in the snapshot.
The di_path_private_get()function allows a caller to retrieve a data
pointer that was associated with a path node obtained by a call to
di_path_private_set().
The di_minor_private_set() function allows a caller to associate
caller-specific data pointed to by data with a minor node specified
by minor, thereby facilitating traversal of minor nodes in the
snapshot.
The di_minor_private_get() function allows a caller to retrieve a
data pointer that was associated with a minor node obtained by a call
to di_minor_private_set().
The di_link_private_set() function allows a caller to associate
caller-specific data pointed to by data with a link, thereby
facilitating traversal of links in the snapshot.
The di_link_private_get() function allows a caller to retrieve a data
pointer that was associated with a link obtained by a call to
di_link_private_set().
The di_lnode_private_set() function allows a caller to associate
caller-specific data pointed to by data with an lnode specified by
lnode, thereby facilitating traversal of lnodes in the snapshot.
The di_lnode_private_get() function allows a caller to retrieve a
data pointer that was associated with an lnode by a call to
di_lnode_private_set().
These functions do not perform any type of locking. It is up to the
caller to satisfy any locking needs.
RETURN VALUES
The di_node_private_set(), di_path_private_set(),
di_minor_private_set(), di_link_private_set(), and
di_lnode_private_set() functions do not return values.
The di_node_private_get(), di_path_private_get(),
di_minor_private_get(), di_link_private_get(), and
di_lnode_private_get() functions return a pointer to caller-specific
data that was initialized with their corresponding *_set() function.
If no caller-specific data was assigned with a *_set() function, the
results are undefined.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
SEE ALSO
di_init(3DEVINFO), libdevinfo(3LIB), attributes(7)
May 15, 2008 DI_NODE_PRIVATE_SET(3DEVINFO)