opensolaris man page for di_walk_minor

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)