di_node_private_set(3DEVINFO)			       Device Information Library Functions			     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 facil-
       itating 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_pri-
       vate_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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       di_init(3DEVINFO), libdevinfo(3LIB), attributes(5)

SunOS 5.11							    15 May 2008 				     di_node_private_set(3DEVINFO)