Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_walk_minor(3devinfo) [opensolaris man page]

di_walk_minor(3DEVINFO) 			       Device Information Library Functions				   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 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. 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(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
dladm(1M), di_minor_nodetype(3DEVINFO), dlpi_walk(3DLPI), libdevinfo(3LIB), attributes(5), filesystem(5), 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_node- type of DDI_NT_NET, in most cases to discover the set of DLPI devices on the system. Solaris now makes a layering distinction between net- working 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(5)). The dlpi_walk(3DLPI) function is the proper function to walk these nodes. SunOS 5.11 14 Jan 2009 di_walk_minor(3DEVINFO)

Check Out this Related Man Page

di_walk_minor(3DEVINFO) 			       Device Information Library Functions				   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 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. 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(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
di_minor_nodetype(3DEVINFO), libdevinfo(3LIB), attributes(5), ddi_create_minor_node(9F) Writing Device Drivers SunOS 5.10 1 Dec 1998 di_walk_minor(3DEVINFO)
Man Page