Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Device Information Library Functionsdi_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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelSafe

SEE ALSO

 

di_minor_nodetype(3DEVINFO), libdevinfo(3DEVINFO), attributes(5), ddi_create_minor_node(9F)

Writing Device Drivers


SunOS 5.9Go To TopLast Changed 1 Dec 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.