Device Information Library Functions
                                   dilinknextbynode(3DEVINFO)



NAME
     dilinknextbynode,  dilinknextbylnode  -   libdevinfo
     link traversal functions

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

     dilinkt dilinknextbynode(dilnodet node, dilinkt link,
          uintt endpoint);


     dilinkt dilinknextbylnode(dinodet lnode, dilinkt link,
          uintt endpoint);


PARAMETERS
     link        The  handle  to  the   current   the   link   or
                 DILINKNIL.


     endpoint    Specify which endpoint of the link the  node  or
                 lnode  should  correspond to, either DILINKTGT
                 or DILINKSRC.


     node        The device node with which the link  is  associ-
                 ated.


     lnode       The lnode with which the link is associated.


DESCRIPTION
     The dilinknextbynode() function returns a handle to  the
     next  link that has the same endpoint node as link.  If link
     is DILINKNIL, a handle is returned to the first link whose
     endpoint specified by endpoint matches the node specified by
     node.


     The dilinknextbylnode() function returns a handle to the
     next link that has the same endpoint lnode as link.  If link
     is DILINKNIL, a handle  is  returned  to  the  first  link
     whose  endpoint  specified  by  endpoint  matches  the lnode
     specified by lnode.

RETURN VALUES
     Upon successful completion, a handle to  the  next  link  is
     returned.   Otherwise,  DILINKNIL is returned and errno is
     set to indicate the error.



SunOS 5.11          Last change: 12 Jul 2004                    1






Device Information Library Functions
                                   dilinknextbynode(3DEVINFO)



ERORS
     The dilinknextbynode() and dilinknextbylnode() func-
     tions will fail if:

     EINVAL    An argument is invalid.


     ENXIO     The end of the link list has been reached.



     The dilinknextbynode() function will fail if:

     ENOTSUP    Device usage  information  is  not  available  in
                snapshot.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     Safe                        
    


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




















SunOS 5.11          Last change: 12 Jul 2004                    2






Device Information Library Functions
                                   dilinknextbynode(3DEVINFO)






















































SunOS 5.11          Last change: 12 Jul 2004                    3