Device Information Library Functions
                                    dinodeprivateset(3DEVINFO)



NAME
     dinodeprivateset,                    dinodeprivateget,
     dipathprivateset,                    dipathprivateget,
     diminorprivateset,                  diminorprivateget,
     dilinkprivateset,                    dilinkprivateget,
     dilnodeprivateset, dilnodeprivateget - manipulate lib-
     devinfo user traversal pointers

SYNOPSIS
     cc [ flag... ] file... -ldevinfo [ library... ]
     #include 

     void dinodeprivateset(dinodet node, void *data);


     void *dinodeprivateget(dinodet node);


     void dipathprivateset(dipatht path, void *data);


     void *dipathprivateget(dipatht path);


     void diminorprivateset(diminort minor, void *data);


     void *diminorprivateget(diminort minor);


     void dilinkprivateset(dilinkt link, void *data);


     void *dilinkprivateget(dilinkt link);


     void dilnodeprivateset(dilnodet lnode, void *data);


     void *dilnodeprivateget(dilnodet lnode);


PARAMETERS
     node     The handle to a devinfo node in a diinit(3DEVINFO)
              snapshot.


     path     The handle to a path node in a snapshot.






SunOS 5.11          Last change: 15 May 2008                    1






Device Information Library Functions
                                    dinodeprivateset(3DEVINFO)



     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 dinodeprivateset() function allows a caller to  asso-
     ciate caller-specific data pointed to by data with a devinfo
     node, thereby facilitating traversal of devinfo nodes in the
     snapshot.


     The  dinodeprivateget()  function  allows  a  caller   to
     retrieve  a  data pointer that was associated with a devinfo
     node obtained by a call to dinodeprivateset().


     The dipathprivateset() function allows a caller to  asso-
     ciate caller-specific data pointed to by data with a devinfo
     path node, thereby facilitating traversal of path  nodes  in
     the snapshot.


     The   dipathprivateget()function  allows  a   caller   to
     retrieve a data pointer that was associated with a path node
     obtained by a call to dipathprivateset().


     The diminorprivateset() function allows a caller to asso-
     ciate  caller-specific  data pointed to by data with a minor
     node specified by minor, thereby facilitating  traversal  of
     minor nodes in the snapshot.


     The  diminorprivateget()  function  allows  a  caller  to
     retrieve  a  data  pointer  that was associated with a minor
     node obtained by a call to diminorprivateset().


     The dilinkprivateset() function allows a caller to  asso-
     ciate  caller-specific  data pointed to by data with a link,
     thereby facilitating traversal of links in the snapshot.





SunOS 5.11          Last change: 15 May 2008                    2






Device Information Library Functions
                                    dinodeprivateset(3DEVINFO)



     The  dilinkprivateget()  function  allows  a  caller   to
     retrieve  a  data  pointer  that  was associated with a link
     obtained by a call to dilinkprivateset().


     The dilnodeprivateset() function allows a caller to asso-
     ciate  caller-specific data pointed to by data with an lnode
     specified by lnode, thereby facilitating traversal of lnodes
     in the snapshot.


     The  dilnodeprivateget()  function  allows  a  caller  to
     retrieve a data pointer that was associated with an lnode by
     a call to dilnodeprivateset().


     These functions do not perform any type of locking. It is up
     to the caller to satisfy any locking needs.

RETURN VALUES
     The      dinodeprivateset(),       dipathprivateset(),
     diminorprivateset(),      dilinkprivateset(),      and
     dilnodeprivateset() functions do not return values.


     The      dinodeprivateget(),       dipathprivateget(),
     diminorprivateget(),      dilinkprivateget(),      and
     dilnodeprivateget()  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 unde-
     fined.

ERORS
     No errors are defined.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:















SunOS 5.11          Last change: 15 May 2008                    3






Device Information Library Functions
                                    dinodeprivateset(3DEVINFO)




           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     diinit(3DEVINFO), libdevinfo(3LIB), attributes(5)











































SunOS 5.11          Last change: 15 May 2008                    4






Device Information Library Functions
                                    dinodeprivateset(3DEVINFO)






















































SunOS 5.11          Last change: 15 May 2008                    5