nvpair_name(3EXT)

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ATTRIBUTES

NAME

nvlist_next_nvpair, nvpair_name, nvpair_type- walk name-value pair lists

SYNOPSIS

$(OS_DIR)/lib/libnvpair.a
#include <libnvpair.h>
#include <sys/nvpair.h>

nvpair_t * nvlist_next_nvpair(nvlist_t * nvl, nvpair_t * nvpair);
char * nvpair_name(nvpair_t * nvpair);
data_type_t nvpair_type(nvpair_t * nvpair);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

PARAMETERS

nvl

nvlist_t to be processed.

nvpair

Handle pointing to a name-value pair

DESCRIPTION

The nvlist_next_nvpair() function returns a handle to the next nvpair in the list. If nvpair is NULL , the first pair is returned. If nvpair is the last pair in the nvlist, NULL is returned.

The nvpair_name() function returns a string containing the name of nvpair . The nvpair_type() function retrieves the value of the nvpair in the form of enumerated type data_type_t . This is used to determine the appropriate nvpair_*() interface to call to retrieve the value.

RETURN VALUE

Stated above

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ATTRIBUTES