nvpair_value_byte(3EXT)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES

NAME

nvpair_value_byte, nvpair_value_int16, nvpair_value_uint16, nvpair_value_int32, nvpair_value_uint32, nvpair_value_int64, nvpair_value_uint64, nvpair_value_string, nvpair_value_byte_array, nvpair_value_int16_array, nvpair_value_uint16_array, nvpair_value_int32_array, nvpair_value_int64_array, nvpair_value_uint32_array, , nvpair_value_uint64_array, nvpair_value_string_array, nvpair_value_hrtime- retrieve the value of name-value pairs

SYNOPSIS

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

int nvpair_value_byte(nvpair_t * nvpair, uchar_t * val);
int nvpair_value_int16(nvpair_t * nvpair, int16_t * val);
int nvpair_value_uint16(nvpair_t * nvpair, uint16_t * val);
int nvpair_value_int32(nvpair_t * nvpair, int32_t val);
int nvpair_value_uint32(nvpair_t * nvpair, uint32_t * val);
int nvpair_value_int64(nvpair_t * nvpair, int64_t * val);
int nvpair_value_uint64(nvpair_t * nvpair, uint64_t * val);
int nvpair_value_string(nvpair_t * nvpair, char ** val);
int nvpair_value_byte_array(nvpair_t * nvpair, uchar_t ** val, uint_t * nelem);
int nvpair_value_int16_array(nvpair_t * nvpair, int16_t ** val, uint16_t * nelem);
int nvpair_value_uint16_array(nvpair_t * nvpair, uint16_t ** val, uint_t * nelem);
int nvpair_value_uint16_array(nvpair_t * nvpair char * name, uint16_t ** val, uint_t * nelem);
int nvpair_value_int32_array(nvpair_t * nvpair, int32_t ** val, uint_t * nelem);
int nvpair_value_uint32_array(nvpair_t * nvpair, int32_t ** val, uint_t * nelem);
int nvpair_value_int64_array(nvpair_t * nvpair, int64_t ** val, uint_t * nelem);
int nvpair_value_uint64_array(nvpair_t * nvpair, uint64_t ** val, uint_t * nelem);
int nvpair_value_string_array(nvpair_t * nvpair, char *** val, uint_t * nelem);
int nvpair_value_hrtime(nvpair_t * nvpair, hrtime_t * val);

PARAMETERS

nvpair

Name--value pair to be processed

nelem

Address to store the number of elements in value

val

Address to store the starting address of the value

DESCRIPTION

The nvpair_value() function retrieves that nvpair value. The nvpair data type must match the interface name for the call to be successful.

There is no nvpair_value_boolean() ; the existence of the name implies that the value is true.

For array data types, including string, the memory containing the data is managed by the library and references to the value remain valid until nvlist_free() is called on the nvlist_t , from which nvpair is obtained.

RETURN VALUE

These functions return 0 upon success. Otherwise, they return one of the following error code.

ERRORS

[EINVAL]

Either one of the argument is NULL , or the type of the nvpair does not match the function name.

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 | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES