Manual Pages for UNIX Operating System command usage for man di_link_next_by_node

Device Information Library Functions
                                   di_link_next_by_node(3DEVINFO)



NAME
     di_link_next_by_node,  di_link_next_by_lnode  -   libdevinfo
     link traversal functions

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

     di_link_t di_link_next_by_node(di_lnode_t node, di_link_t link,
          uint_t endpoint);


     di_link_t di_link_next_by_lnode(di_node_t lnode, di_link_t link,
          uint_t endpoint);


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


     endpoint    Specify which endpoint of the link the  node  or
                 lnode  should  correspond to, either DI_LINK_TGT
                 or DI_LINK_SRC.


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


     lnode       The lnode with which the link is associated.


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


     The di_link_next_by_lnode() function returns a handle to the
     next link that has the same endpoint lnode as link.  If link
     is DI_LINK_NIL, 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,  DI_LINK_NIL is returned and errno is
     set to indicate the error.



SunOS 5.11          Last change: 12 Jul 2004                    1






Device Information Library Functions
                                   di_link_next_by_node(3DEVINFO)



ERRORS
     The di_link_next_by_node() and di_link_next_by_lnode() func-
     tions will fail if:

     EINVAL    An argument is invalid.


     ENXIO     The end of the link list has been reached.



     The di_link_next_by_node() function will fail if:

     ENOTSUP    Device usage  information  is  not  available  in
                snapshot.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


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




















SunOS 5.11          Last change: 12 Jul 2004                    2






Device Information Library Functions
                                   di_link_next_by_node(3DEVINFO)






















































SunOS 5.11          Last change: 12 Jul 2004                    3