DI_WALK_NODE(3DEVINFO) Device Information Library Functions
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_callback() 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
SEE ALSO
di_init(3DEVINFO),
libdevinfo(3LIB),
attributes(7) Writing Device Drivers January 16, 2009 DI_WALK_NODE(3DEVINFO)
