1libnvpair(3LIB)               Interface Libraries              libnvpair(3LIB)
2
3
4

NAME

6       libnvpair - name-value pair library
7

SYNOPSIS

9       cc [ flag... ] file... -lnvpair [ library... ]
10       #include <libnvpair.h>
11
12

DESCRIPTION

14       The  libnvpair  library  exports  a set of functions for managing name-
15       value pairs.
16
17
18       The library defines four opaque handles:
19
20       nvpair_t          handle to a name-value pair
21
22
23       nvlist_t          handle to a list of name-value pairs
24
25
26       nv_alloc_t        handle to a pluggable allocator
27
28
29       nv_alloc_ops_t    handle to pluggable allocator operations
30
31
32
33       The library supports the following operations:
34
35           o      Allocate and free an nvlist_t.
36
37           o      Specify the  allocater  to  be  used  when  manipulating  an
38                  nvlist_t.
39
40           o      Add and remove an nvpair_t from a list.
41
42           o      Search nvlist_t for a specified name pair.
43
44           o      Pack an nvlist_t into a contiguous buffer.
45
46           o      Expand a packed nvlist into a searchable nvlist_t.
47

INTERFACES

49       The shared object libnvpair.so.1 provides the public interfaces defined
50       below. See Intro(3) for additional information on shared object  inter‐
51       faces.
52
53
54
55
56       nvlist_add_boolean            nvlist_add_boolean_value
57       nvlist_add_boolean_array      nvlist_add_byte
58       nvlist_add_byte_array         nvlist_add_double
59       nvlist_add_int8               nvlist_add_int8_array
60       nvlist_add_int16              nvlist_add_int16_array
61       nvlist_add_int32              nvlist_add_int32_array
62       nvlist_add_int64              nvlist_add_int64_array
63       nvlist_add_nvlist             nvlist_add_nvlist_array
64       nvlist_add_nvpair             nvlist_add_string
65       nvlist_add_string_array       nvlist_add_uint8
66
67       nvlist_add_uint8_array        nvlist_add_uint16
68       nvlist_add_uint16_array       nvlist_add_uint32
69       nvlist_add_uint32_array       nvlist_add_uint64
70       nvlist_add_uint64_array       nvlist_alloc
71       nvlist_dup                    nvlist_exists
72       nvlist_free                   nvlist_lookup_boolean
73       nvlist_lookup_boolean_value   nvlist_lookup_boolean_array
74       nvlist_lookup_byte            nvlist_lookup_byte_array
75       nvlist_lookup_double          nvlist_lookup_int8
76       nvlist_lookup_int8_array      nvlist_lookup_int16
77       nvlist_lookup_int16_array     nvlist_lookup_int32
78       nvlist_lookup_int32_array     nvlist_lookup_int64
79       nvlist_lookup_int64_array     nvlist_lookup_nvlist
80       nvlist_lookup_nvlist_array    nvlist_lookup_nv_alloc
81       nvlist_lookup_nvpair          nvlist_lookup_pairs
82       nvlist_lookup_string          nvlist_lookup_string_array
83       nvlist_lookup_uint8           nvlist_lookup_uint8_array
84       nvlist_lookup_uint16          nvlist_lookup_uint16_array
85       nvlist_lookup_uint32          nvlist_lookup_uint32_array
86       nvlist_lookup_uint64          nvlist_lookup_uint64_array
87       nvlist_merge                  nvlist_next_nvpair
88       nvlist_pack                   nvlist_remove
89       nvlist_remove_all             nvlist_size
90       nvlist_unpack                 nvlist_xalloc
91       nvlist_xdup                   nvlist_xpack
92       nvlist_xunpack                nvpair_name
93       nvpair_type                   nvpair_value_boolean_array
94       nvpair_value_boolean_value    nvpair_value_byte
95       nvpair_value_byte_array       nvpair_value_double
96       nvpair_value_int8             nvpair_value_int8_array
97       nvpair_value_int16            nvpair_value_int16_array
98       nvpair_value_int32            nvpair_value_int32_array
99       nvpair_value_int64            nvpair_value_int64_array
100       nvpair_value_nvlist           nvpair_value_nvlist_array
101       nvpair_value_string           nvpair_value_string_array
102       nvpair_value_uint8            nvpair_value_uint8_array
103       nvpair_value_uint16           nvpair_value_uint16_array
104       nvpair_value_uint32           nvpair_value_uint32_array
105       nvpair_value_uint64           nvpair_value_uint64_array
106       nv_alloc_init                 nv_alloc_fini
107       nv_alloc_reset
108
109

FILES

111       /lib/libnvpair.so.1       shared object
112
113
114       /lib/64/libnvpair.so.1    64-bit shared object
115
116

ATTRIBUTES

118       See attributes(5) for description of the following attributes:
119
120
121
122
123       ┌─────────────────────────────┬─────────────────────────────┐
124       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
125       ├─────────────────────────────┼─────────────────────────────┤
126       │Availability                 │SUNWcsl (32-bit)             │
127       ├─────────────────────────────┼─────────────────────────────┤
128       │                             │SUNWcslx (64-bit)            │
129       ├─────────────────────────────┼─────────────────────────────┤
130       │Interface Stability          │Committed                    │
131       ├─────────────────────────────┼─────────────────────────────┤
132       │MT-Level                     │MT-Safe                      │
133       └─────────────────────────────┴─────────────────────────────┘
134

SEE ALSO

136       Intro(3), attributes(5)
137
138
139
140SunOS 5.11                        1 Aug 2008                   libnvpair(3LIB)
Impressum