di_lnode_private_set(DeviceFInformation Library di_lnode_private_set(3DEVINFO)NAME
di_lnode_private_set, di_lnode_private_get, di_minor_private_set,
di_minor_private_get, di_node_private_set, di_node_private_get,
di_link_private_set, di_link_private_get - manipulate libdevinfo user
traversal pointers
SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ]
#include <libdevinfo.h>
void di_lnode_private_set(di_lnode_t lnode, void *data);
void *di_lnode_private_get(di_lnode_t lnode);
void di_minor_private_set(di_minor_t minor, void *data);
void *di_minor_private_get(di_minor_t minor);
void di_node_private_set(di_node_t node, void *data);
void *di_node_private_get(di_node_t node);
void di_link_private_set(di_link_t link, void *data);
void *di_link_private_get(di_link_t link);
PARAMETERS
lnode A handle to an lnode.
minor A handle to a minor node.
node A handle to a devinfo node.
link A handle to a link.
data A pointer to caller-specific data.
DESCRIPTION
The di_lnode_private_set() function allows a caller to associate call‐
er-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_pri‐
vate_set().
The di_minor_private_set() function allows a caller to associate call‐
er-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_node_private_set() function allows a caller to associate caller-
specific data pointed to by data with a devinfo node, thereby facili‐
tating 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_link_private_set() function allows a caller to associate caller-
specific data pointed to by data with a link, thereby facilitating tra‐
versal 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().
These functions do not perform any type of locking. It is up to the
caller to satisfy any locking needs.
RETURN VALUES
The di_lnode_private_set(), di_minor_private_set(), di_node_pri‐
vate_set(), and di_link_private_set() functions do not return values.
The di_lnode_private_get(), di_minor_private_get(), di_node_pri‐
vate_get(), and di_node_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(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Evolving │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOdi_init(3DEVINFO), libdevinfo(3LIB), attributes(5)SunOS 5.10 22 Mar 2004 di_lnode_private_set(3DEVINFO)