|
Device Information Library Functions | di_walk_minor(3DEVINFO) |
| di_walk_minor - traverse libdevinfo minor nodes |
SYNOPSIS
|
cc [ flag... ] file... -ldevinfo [ library... ]
#include <libdevinfo.h> int di_walk_minor(di_node_t root, const char *minor_nodetype, uint_t flag, void *arg, int (*minor_callback)(di_node_t node, di_minor_t minor, void *arg)); |
|
-
arg
- Pointer to caller- specific user data.
-
flag
- Specify 0. Reserved for future use.
-
minor
- The minor node visited.
-
minor_nodetype
- A character string specifying the minor data type, which may be one of the types defined by the Solaris DDI framework, for example, DDI_NT_BLOCK. NULL matches all minor_node types. See ddi_create_minor_node(9F).
-
node
- The device node with which to the minor node is associated.
-
root
- Root of subtree to visit.
|
|
The di_walk_minor() function visits all minor nodes attached to device nodes in a subtree rooted at root. For each minor node that matches minor_nodetype, the caller-supplied function minor_callback() is invoked.
The walk terminates immediately when minor_callback() returns DI_WALK_TERMINATE.
|
|
Upon successful completion, di_walk_minor() returns 0. Otherwise, -1 is returned and errno is set to indicate the error.
The minor_callback() function returns one of the following:
-
DI_WALK_CONTINUE
- Continue to visit subsequent minor data nodes.
-
DI_WALK_TERMINATE
- Terminate the walk immediately.
|
|
The di_walk_minor() function will fail if:
-
EINVAL
- Invalid argument.
|
|
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Interface Stability | Evolving |
MT-Level | Safe |
|
| |