Print this page
patch more-manpage
patch cleanup


 124                    specified nvlist_t.
 125 
 126 
 127 DESCRIPTION
 128    List Manipulation
 129        The nvlist_alloc() function allocates a new name-value pair list and
 130        updates nvlp to point to the handle. The nvflag argument specifies
 131        nvlist properties to remain persistent across packing, unpacking, and
 132        duplication. If NV_UNIQUE_NAME was specified for nvflag, existing
 133        nvpairs with matching names are removed before the new nvpair is added.
 134        If NV_UNIQUE_NAME_TYPE was specified for nvflag, existing nvpairs with
 135        matching names and data types are removed before the new nvpair is
 136        added. See nvlist_add_byte(3NVPAIR) for more information.
 137 
 138 
 139        The nvlist_xalloc() function is identical to nvlist_alloc() except that
 140        nvlist_xalloc() can use a different allocator, as described in the
 141        Pluggable Allocators section.
 142 
 143 
 144        The nvlist_free() function frees a name-value pair list.

 145 
 146 
 147        The nvlist_size() function returns the minimum size of a contiguous
 148        buffer large enough to pack nvl. The encoding parameter specifies the
 149        method of encoding when packing nvl. Supported encoding methods are:
 150 
 151        NV_ENCODE_NATIVE
 152                            Straight bcopy() as described in bcopy(3C).
 153 
 154 
 155        NV_ENCODE_XDR
 156                            Use XDR encoding, suitable for sending to another
 157                            host.
 158 
 159 
 160 
 161        The nvlist_pack() function packs nvl into contiguous memory starting at
 162        *bufp. The encoding parameter specifies the method of encoding (see
 163        above).
 164 


 424 
 425 ATTRIBUTES
 426        See attributes(5) for descriptions of the following attributes:
 427 
 428 
 429 
 430 
 431        +--------------------+-----------------+
 432        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 433        +--------------------+-----------------+
 434        |Interface Stability | Evolving        |
 435        +--------------------+-----------------+
 436        |MT-Level            | MT-Safe         |
 437        +--------------------+-----------------+
 438 
 439 SEE ALSO
 440        libnvpair(3LIB), attributes(5), nvlist_alloc(9F)
 441 
 442 
 443 
 444                                February 2, 2004          NVLIST_ALLOC(3NVPAIR)


 124                    specified nvlist_t.
 125 
 126 
 127 DESCRIPTION
 128    List Manipulation
 129        The nvlist_alloc() function allocates a new name-value pair list and
 130        updates nvlp to point to the handle. The nvflag argument specifies
 131        nvlist properties to remain persistent across packing, unpacking, and
 132        duplication. If NV_UNIQUE_NAME was specified for nvflag, existing
 133        nvpairs with matching names are removed before the new nvpair is added.
 134        If NV_UNIQUE_NAME_TYPE was specified for nvflag, existing nvpairs with
 135        matching names and data types are removed before the new nvpair is
 136        added. See nvlist_add_byte(3NVPAIR) for more information.
 137 
 138 
 139        The nvlist_xalloc() function is identical to nvlist_alloc() except that
 140        nvlist_xalloc() can use a different allocator, as described in the
 141        Pluggable Allocators section.
 142 
 143 
 144        The nvlist_free() function frees a name-value pair list. If nvl is a
 145        null pointer, no action occurs.
 146 
 147 
 148        The nvlist_size() function returns the minimum size of a contiguous
 149        buffer large enough to pack nvl. The encoding parameter specifies the
 150        method of encoding when packing nvl. Supported encoding methods are:
 151 
 152        NV_ENCODE_NATIVE
 153                            Straight bcopy() as described in bcopy(3C).
 154 
 155 
 156        NV_ENCODE_XDR
 157                            Use XDR encoding, suitable for sending to another
 158                            host.
 159 
 160 
 161 
 162        The nvlist_pack() function packs nvl into contiguous memory starting at
 163        *bufp. The encoding parameter specifies the method of encoding (see
 164        above).
 165 


 425 
 426 ATTRIBUTES
 427        See attributes(5) for descriptions of the following attributes:
 428 
 429 
 430 
 431 
 432        +--------------------+-----------------+
 433        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 434        +--------------------+-----------------+
 435        |Interface Stability | Evolving        |
 436        +--------------------+-----------------+
 437        |MT-Level            | MT-Safe         |
 438        +--------------------+-----------------+
 439 
 440 SEE ALSO
 441        libnvpair(3LIB), attributes(5), nvlist_alloc(9F)
 442 
 443 
 444 
 445                                February 15, 2016         NVLIST_ALLOC(3NVPAIR)