Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_walk_link(3devinfo) [opensolaris 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.11 22 Mar 2004 di_walk_link(3DEVINFO)

Check Out this Related Man Page

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

NAME
di_walk_node - traverse libdevinfo device nodes SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> int di_walk_node(di_node_t root, uint_t flag, void *arg, int (*node_callback)(di_node_t node, void *arg)); DESCRIPTION
The di_walk_node() function visits all nodes in the subtree rooted at root. For each node found, the caller-supplied function node_call- back() is invoked. The return value of node_callback() specifies subsequent walking behavior. PARAMETERS
arg Pointer to caller-specific data. flag Specifies walking order, either DI_WALK_CLDFIRST (depth first) or DI_WALK_SIBFIRST (breadth first). DI_WALK_CLDFIRST is the default. node The node being visited. root The handle to the root node of the subtree to visit. RETURN VALUES
Upon successful completion, di_walk_node() returns 0. Otherwise, -1 is returned and errno is set to indicate the error. The node_callback() function can return one of the following: DI_WALK_CONTINUE Continue walking. DI_WALK_PRUNESIB Continue walking, but skip siblings and their child nodes. DI_WALK_PRUNECHILD Continue walking, but skip subtree rooted at current node . DI_WALK_TERMINATE Terminate the walk immediately. ERRORS
The di_walk_node() function will fail if: EINVAL Invalid argument. 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) Writing Device Drivers SunOS 5.10 1 Dec 1998 di_walk_node(3DEVINFO)
Man Page