Device Information Library Functions di_walk_lnode(3DEVINFO)
NAME
di_walk_lnode - traverse libdevinfo lnodes
SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ]
#include
int di_walk_lnode(di_node_t root, uint_t flag, void *arg,
int (*lnode_callback)(di_lnode_t link, void *arg));
PARAMETERS
root The handle to the root node of the subtree to visit. flag Specify 0. Reserved for future use.arg A pointer to caller-specific data.
lnode_callback The caller-supplied callback function.
DESCRIPTION
The di_walk_lnode() function visits all nodes in the subtree
rooted at root. For each node found, the caller-supplied
function lnode_callback() is invoked for each lnode associ-
ated with that node. The return value of lnode_callback()
specifies subsequent walking behavior where that node is the specified endpoint of the link.RETURN VALUES
Upon successful completion, di_walk_lnode() returns 0. Oth-
erwise, -1 is returned and errno is set to indicate the
error.The callback function lnode_callback() can return one of the
following:DI_WALK_CONTINUE Continue walking.
DI_WALK_TERMINATE Terminate the walk immediately.
ERRORS
The di_walk_lnode() function will fail if:
SunOS 5.11 Last change: 22 Mar 2004 1
Device Information Library Functions di_walk_lnode(3DEVINFO)
EINVAL An argument is invalid.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: 22 Mar 2004 2