di_lnode_private_set(3DEVINFO)			       Device Information Library Functions			    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 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().

       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_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_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().

       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_private_set(), and di_link_private_set() functions do not return values.

       The di_lnode_private_get(), di_minor_private_get(), di_node_private_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 ALSO

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

SunOS 5.10							    22 Mar 2004 				    di_lnode_private_set(3DEVINFO)