NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
cc [ flag... ] file... -lnvpair [ library... ] #include <libnvpair.h>int nvlist_lookup_boolean(nvlist_t *nvl, char *name);
The nvlist_t to be processed.
Name of the name-value pair to search.
Address to store the number of elements in value.
Address to store the starting address of the value.
These functions find the nvpair (name-value pair) that matches the name and type as indicated by the interface name. If one is found, nelem and val are modified to contain the number of elements in value and the starting address of data, respectively.
These functions work for nvlists (lists of name-value pairs) allocated with NV_UNIQUE_NAME or NV_UNIQUE_NAME_TYPE specified in nvlist_alloc(). (See nv_list_alloc(3NVPAIR).) If this is not the case, the function returns ENOTSUP because the list potentially contains multiple nvpairs with the same name and type.
All memory required for storing the array elements, including string value, are managed by the library. References to such data remain valid until nvlist_free() is called on nvl.
These functions return 0 on success and an error value on failure.
These functions will fail if:
There is an invalid argument.
No matching name-value pair is found
An encode/decode method is not supported.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
MT-Level | MT-Safe |
NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO