DI_PATH_PROP_NEXT(3DEVINFO) Device Information Library Functions

NAME

di_path_prop_next - libdevinfo path property traversal function

SYNOPSIS

cc [ flag... ] file... -ldevinfo [ library... ]
#include <libdevinfo.h>

di_path_prop_t di_path_prop_next(di_path_t path,
di_path_prop_t prop);

PARAMETERS

path
The handle to a path node in a di_init(3DEVINFO).


prop
The handle to a property.

DESCRIPTION

The di_prop_next() function returns a handle to the next property on
the property list. If prop is DI_PROP_NIL, the handle to the first
property is returned.

RETURN VALUES

Upon successful completion, di_path_prop_next() returns a handle to a
path property object. Otherwise DI_PROP_NIL is returned, and errno is
set to indicate the error.

ERRORS

The di_prop_next() function will fail if:

EINVAL
An argument is invalid.


ENOTSUP
The snapshot does not contain path property information
(DINFOPROP was not passed to di_init()).


ENXIO
There are no more properties.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO

libdevinfo(3LIB), attributes(7)


Writing Device Drivers

May 15, 2008 DI_PATH_PROP_NEXT(3DEVINFO)