nvlist_lookup_nvpair.3nvpair revision c10c16dec587a0662068f6e2991c29ed3a9db943
te
Copyright (c) 2007, Sun Microsystems Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
nvlist_lookup_nvpair 3NVPAIR "24 Oct 2007" "SunOS 5.11" "Name-value Pair Library Functions"
NAME
nvlist_lookup_nvpair, nvlist_exists - lookup named pairs
SYNOPSIS

cc [ flag... ] file... -lnvpair [ library... ]
#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 matching name, regardless of type. It is valid only for lists allocated with NV_UNIQUE_NAME. See nvlist_alloc(3NVPAIR).

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 TYPEATTRIBUTE VALUE
Interface StabilityCommitted
MT-LevelMT-Safe
SEE ALSO

libnvpair(3LIB), nvlist_alloc(3NVPAIR), attributes(5), nvlist_lookup_nvpair(9F)