Interface Libraries                               libnvpair(3LIB)



NAME
     libnvpair - name-value pair library

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


DESCRIPTION
     The libnvpair library exports a set of functions for  manag-
     ing name-value pairs.


     The library defines four opaque handles:

     nvpairt          handle to a name-value pair


     nvlistt          handle to a list of name-value pairs


     nvalloct        handle to a pluggable allocator


     nvallocopst    handle to pluggable allocator operations



     The library supports the following operations:

         o    Allocate and free an nvlistt.

         o    Specify the allocater to be used when  manipulating
              an nvlistt.

         o    Add and remove an nvpairt from a list.

         o    Search nvlistt for a specified name pair.

         o    Pack an nvlistt into a contiguous buffer.

         o    Expand a packed nvlist into a searchable nvlistt.

INTERFACES
     The shared object libnvpair.so.1 provides the public  inter-
     faces defined below. See Intro(3) for additional information
     on shared object interfaces.



     nvlistaddboolean            nvlistaddbooleanvalue
     nvlistaddbooleanarray      nvlistaddbyte



SunOS 5.11           Last change: 1 Aug 2008                    1






Interface Libraries                               libnvpair(3LIB)



     nvlistaddbytearray         nvlistadddouble
     nvlistaddint8               nvlistaddint8array
     nvlistaddint16              nvlistaddint16array
     nvlistaddint32              nvlistaddint32array
     nvlistaddint64              nvlistaddint64array
     nvlistaddnvlist             nvlistaddnvlistarray
     nvlistaddnvpair             nvlistaddstring
     nvlistaddstringarray       nvlistadduint8
     nvlistadduint8array        nvlistadduint16
     nvlistadduint16array       nvlistadduint32
     nvlistadduint32array       nvlistadduint64
     nvlistadduint64array       nvlistalloc
     nvlistdup                    nvlistexists
     nvlistfree                   nvlistlookupboolean
     nvlistlookupbooleanvalue   nvlistlookupbooleanarray
     nvlistlookupbyte            nvlistlookupbytearray
     nvlistlookupdouble          nvlistlookupint8
     nvlistlookupint8array      nvlistlookupint16
     nvlistlookupint16array     nvlistlookupint32
     nvlistlookupint32array     nvlistlookupint64
     nvlistlookupint64array     nvlistlookupnvlist
     nvlistlookupnvlistarray    nvlistlookupnvalloc
     nvlistlookupnvpair          nvlistlookuppairs
     nvlistlookupstring          nvlistlookupstringarray
     nvlistlookupuint8           nvlistlookupuint8array
     nvlistlookupuint16          nvlistlookupuint16array
     nvlistlookupuint32          nvlistlookupuint32array
     nvlistlookupuint64          nvlistlookupuint64array
     nvlistmerge                  nvlistnextnvpair
     nvlistpack                   nvlistremove
     nvlistremoveall             nvlistsize
     nvlistunpack                 nvlistxalloc
     nvlistxdup                   nvlistxpack
     nvlistxunpack                nvpairname
     nvpairtype                   nvpairvaluebooleanarray
     nvpairvaluebooleanvalue    nvpairvaluebyte
     nvpairvaluebytearray       nvpairvaluedouble
     nvpairvalueint8             nvpairvalueint8array
     nvpairvalueint16            nvpairvalueint16array
     nvpairvalueint32            nvpairvalueint32array
     nvpairvalueint64            nvpairvalueint64array
     nvpairvaluenvlist           nvpairvaluenvlistarray
     nvpairvaluestring           nvpairvaluestringarray
     nvpairvalueuint8            nvpairvalueuint8array
     nvpairvalueuint16           nvpairvalueuint16array
     nvpairvalueuint32           nvpairvalueuint32array
     nvpairvalueuint64           nvpairvalueuint64array
     nvallocinit                 nvallocfini
     nvallocreset






SunOS 5.11           Last change: 1 Aug 2008                    2






Interface Libraries                               libnvpair(3LIB)



FILES
     /lib/libnvpair.so.1       shared object


     /lib/64/libnvpair.so.1    64-bit shared object


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsl (32-bit)            
    
                                  SUNWcslx (64-bit)           
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     Intro(3), attributes(5)



























SunOS 5.11           Last change: 1 Aug 2008                    3