1libnvpair(3LIB) Interface Libraries libnvpair(3LIB)
2
3
4
6 libnvpair - name-value pair library
7
9 cc [ flag... ] file... -lnvpair [ library... ]
10 #include <libnvpair.h>
11
12
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
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
111 /lib/libnvpair.so.1 shared object
112
113
114 /lib/64/libnvpair.so.1 64-bit shared object
115
116
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
136 Intro(3), attributes(5)
137
138
139
140SunOS 5.11 1 Aug 2008 libnvpair(3LIB)