DI_WALK_MINOR(3DEVINFO) Device Information Library Functions
di_walk_minor - traverse libdevinfo minor nodes
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
illumos 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
dladm(8), di_minor_nodetype(3DEVINFO), dlpi_walk(3DLPI),
libdevinfo(3LIB), attributes(7), filesystem(7),
ddi_create_minor_node(9F)
Writing Device Drivers
The di_walk_minor() function is no longer an accurate method for
walking network datalink interfaces on the system. Applications
should use dlpi_walk(3DLPI) instead. It has been common for
applications to use di_walk_minor() to walk networking devices by
passing in a minor_nodetype of DDI_NT_NET, in most cases to discover
the set of DLPI devices on the system. illumos now makes a layering
distinction between networking devices (the objects displayed in the
DEVICE field by dladm show-phys) and network datalink interfaces (the
objects displayed by dladm show-link). Datalink interfaces are
represented as the set of DLPI device nodes that applications can
open by using dlpi_open(3DLPI) or by opening DLPI nodes out of the
/dev/net filesystem (see filesystem(7)). The dlpi_walk(3DLPI)
function is the proper function to walk these nodes.
January 14, 2009 DI_WALK_MINOR(3DEVINFO)
NAME
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));
PARAMETERS
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
illumos 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.
DESCRIPTION
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.
RETURN VALUES
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.
ERRORS
The di_walk_minor() 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
dladm(8), di_minor_nodetype(3DEVINFO), dlpi_walk(3DLPI),
libdevinfo(3LIB), attributes(7), filesystem(7),
ddi_create_minor_node(9F)
Writing Device Drivers
NOTES
The di_walk_minor() function is no longer an accurate method for
walking network datalink interfaces on the system. Applications
should use dlpi_walk(3DLPI) instead. It has been common for
applications to use di_walk_minor() to walk networking devices by
passing in a minor_nodetype of DDI_NT_NET, in most cases to discover
the set of DLPI devices on the system. illumos now makes a layering
distinction between networking devices (the objects displayed in the
DEVICE field by dladm show-phys) and network datalink interfaces (the
objects displayed by dladm show-link). Datalink interfaces are
represented as the set of DLPI device nodes that applications can
open by using dlpi_open(3DLPI) or by opening DLPI nodes out of the
/dev/net filesystem (see filesystem(7)). The dlpi_walk(3DLPI)
function is the proper function to walk these nodes.
January 14, 2009 DI_WALK_MINOR(3DEVINFO)