Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_link_next_by_lnode(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_lnode_private_set(3DEVINFO)			       Device Information Library Functions			    di_lnode_private_set(3DEVINFO)

NAME
di_lnode_private_set, di_lnode_private_get, di_minor_private_set, di_minor_private_get, di_node_private_set, di_node_private_get, di_link_private_set, di_link_private_get - manipulate libdevinfo user traversal pointers SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> void di_lnode_private_set(di_lnode_t lnode, void *data); void *di_lnode_private_get(di_lnode_t lnode); void di_minor_private_set(di_minor_t minor, void *data); void *di_minor_private_get(di_minor_t minor); void di_node_private_set(di_node_t node, void *data); void *di_node_private_get(di_node_t node); void di_link_private_set(di_link_t link, void *data); void *di_link_private_get(di_link_t link); PARAMETERS
lnode A handle to an lnode. minor A handle to a minor node. node A handle to a devinfo node. link A handle to a link. data A pointer to caller-specific data. DESCRIPTION
The di_lnode_private_set() function allows a caller to associate caller-specific data pointed to by data with an lnode specified by lnode, thereby facilitating traversal of lnodes in the snapshot. The di_lnode_private_get() function allows a caller to retrieve a data pointer that was associated with an lnode by a call to di_lnode_pri- vate_set(). The di_minor_private_set() function allows a caller to associate caller-specific data pointed to by data with a minor node specified by minor, thereby facilitating traversal of minor nodes in the snapshot. The di_minor_private_get() function allows a caller to retrieve a data pointer that was associated with a minor node obtained by a call to di_minor_private_set(). The di_node_private_set() function allows a caller to associate caller-specific data pointed to by data with a devinfo node, thereby facil- itating traversal of devinfo nodes in the snapshot. The di_node_private_get() function allows a caller to retrieve a data pointer that was associated with a devinfo node obtained by a call to di_node_private_set(). The di_link_private_set() function allows a caller to associate caller-specific data pointed to by data with a link, thereby facilitating traversal of links in the snapshot. The di_link_private_get() function allows a caller to retrieve a data pointer that was associated with a link obtained by a call to di_link_private_set(). These functions do not perform any type of locking. It is up to the caller to satisfy any locking needs. RETURN VALUES
The di_lnode_private_set(), di_minor_private_set(), di_node_private_set(), and di_link_private_set() functions do not return values. The di_lnode_private_get(), di_minor_private_get(), di_node_private_get(), and di_node_private_get() 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 undefined. ERRORS
No errors are defined. 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_lnode_private_set(3DEVINFO)
Man Page