Name-value Pair Library Functions   nvlistlookupnvpair(3NVPAIR)



NAME
     nvlistlookupnvpair, nvlistexists - lookup named pairs

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

     int nvlistlookupnvpair(nvlistt *nvl, const char *name,
          nvpairt **nvp);


     booleant nvlistexists(nvlistt *nvl, const char *name);


DESCRIPTION
     The nvlistlookupnvpair() function returns the nvpair  with
     the  matching name, regardless of type. It is valid only for
     lists      allocated      with      NVUNIQUENAME.      See
     nvlistalloc(3NVPAIR).


     The nvlistexists() function returns success if  any  nvpair
     exists  with  the  given  name. It is valid for all types of
     lists.

RETURN VALUES
     The nvlistlookupnvpair() function returns 0 on success and
     an error value on failure.


     The nvlistexists() function returns  BTRUE  if  an  nvpair
     with the given name exists and BFALSE otherwise.

ERORS
     The nvlistlookupnvpair() 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 NVUNIQUENAME.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







SunOS 5.11          Last change: 24 Oct 2007                    1






Name-value Pair Library Functions   nvlistlookupnvpair(3NVPAIR)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libnvpair(3LIB),    nvlistalloc(3NVPAIR),    attributes(5),
     nvlistlookupnvpair(9F)











































SunOS 5.11          Last change: 24 Oct 2007                    2