Content-type: text/html Man page of di_link_next_by_node

di_link_next_by_node

Section: Device Information Library Functions (3DEVINFO)
Updated: 12 Jul 2004
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelSafe

 

SEE ALSO

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


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:19 GMT, October 02, 2010