Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_link_next_by_node(3devinfo) [opensolaris man page]

di_link_next_by_node(3DEVINFO)			       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 <libdevinfo.h>

       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 associated.

       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.

ERRORS

       The di_link_next_by_node() and di_link_next_by_lnode() functions 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 attributes:

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

SEE ALSO

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

SunOS 5.11							    12 Jul 2004 				    di_link_next_by_node(3DEVINFO)

Check Out this Related Man Page

di_walk_link(3DEVINFO)				       Device Information Library Functions				    di_walk_link(3DEVINFO)

NAME

       di_walk_link - traverse libdevinfo links

SYNOPSIS

       cc [ flag... ] file... -ldevinfo [ library... ]
       #include <libdevinfo.h>

       int di_walk_link(di_node_t root, uint_t flag, uint_t endpoint, void *arg, int (*link_callback)(di_link_t link, void *arg));

PARAMETERS

       root	       The handle to the root node of the subtree to visit.

       flag	       Specify 0. Reserved for future use.

       endpoint        Specify if the current node being visited should be the target or source of an link, either DI_LINK_TGT or DI_LINK_SRC

       arg	       A pointer to caller-specific data.

       link_callback   The caller-supplied callback function.

DESCRIPTION

       The  di_walk_link()  function visits all nodes in the subtree rooted at root.  For each node found, the caller-supplied function link_call-
       back() is invoked for each link associated with that node where that node is the specified endpoint of  the  link.   The  return  value	of
       link_callback() specifies subsequent walking behavior. See RETURN VALUES.

RETURN VALUES

       Upon successful completion, di_walk_link() returns 0.  Otherwise, -1 is returned and errno is set to indicate the error.

       The callback function, link_callback(), can return one of the following:

       DI_WALK_CONTINUE        Continue walking.

       DI_WALK_TERMINATE       Terminate the walk immediately.

ERRORS

       The di_walk_link() function will fail if:

       EINVAL	       An argument is invalid.

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_walk_link(3DEVINFO)
Man Page