nvlist_lookup_nvpair(9F) Kernel Functions for Drivers nvlist_lookup_nvpair(9F)NAME
nvlist_lookup_nvpair, nvlist_exists - lookup named pairs
SYNOPSIS
#include <libnvpair.h>
int nvlist_lookup_nvpair(nvlist_t *nvl, const char *name,
nvpair_t **nvp);
boolean_t nvlist_exists(nvlist_t *nvl, const char *name);
DESCRIPTION
The nvlist_lookup_nvpair() function returns the nvpair with the match‐
ing name, regardless of type. It is valid only for lists allocated with
NV_UNIQUE_NAME. See nvlist_alloc(9F).
The nvlist_exists() function returns success if any nvpair exists with
the given name. It is valid for all types of lists.
RETURN VALUES
The nvlist_lookup_nvpair() function returns 0 on success and an error
value on failure.
The nvlist_exists() function returns B_TRUE if an nvpair with the given
name exists and B_FALSE otherwise.
ERRORS
The nvlist_lookup_nvpair() function will fail if:
EINVAL There is an invalid argument.
ENOENT No matching name-value pair is found.
ENOTSUP The list was not allocated with NV_UNIQUE_NAME.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOnvlist_lookup_nvpair(3NVPAIR), nvlist_alloc(9F), attributes(5)SunOS 5.11 24 Oct 2007 nvlist_lookup_nvpair(9F)