Manual Pages for UNIX Operating System command usage for man nvlist_lookup_nvpair

Name-value Pair Library Functions   nvlist_lookup_nvpair(3NVPAIR)



NAME
     nvlist_lookup_nvpair, nvlist_exists - lookup named pairs

SYNOPSIS
     cc [ flag... ] file... -lnvpair [ library... ]
     #include 

     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  attri-
     butes:







SunOS 5.11          Last change: 24 Oct 2007                    1






Name-value Pair Library Functions   nvlist_lookup_nvpair(3NVPAIR)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


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











































SunOS 5.11          Last change: 24 Oct 2007                    2