]>
Commit | Line | Data |
---|---|---|
34dc7c2f BB |
1 | /* |
2 | * CDDL HEADER START | |
3 | * | |
4 | * The contents of this file are subject to the terms of the | |
5 | * Common Development and Distribution License (the "License"). | |
6 | * You may not use this file except in compliance with the License. | |
7 | * | |
8 | * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE | |
9 | * or http://www.opensolaris.org/os/licensing. | |
10 | * See the License for the specific language governing permissions | |
11 | * and limitations under the License. | |
12 | * | |
13 | * When distributing Covered Code, include this CDDL HEADER in each | |
14 | * file and include the License file at usr/src/OPENSOLARIS.LICENSE. | |
15 | * If applicable, add the following below this CDDL HEADER, with the | |
16 | * fields enclosed by brackets "[]" replaced with your own identifying | |
17 | * information: Portions Copyright [yyyy] [name of copyright owner] | |
18 | * | |
19 | * CDDL HEADER END | |
20 | */ | |
21 | /* | |
572e2857 | 22 | * Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved. |
9ae529ec | 23 | * Copyright (c) 2012 by Delphix. All rights reserved. |
34dc7c2f BB |
24 | */ |
25 | ||
26 | #ifndef _SYS_NVPAIR_H | |
27 | #define _SYS_NVPAIR_H | |
28 | ||
34dc7c2f | 29 | #include <sys/types.h> |
9ae529ec | 30 | #include <sys/time.h> |
34dc7c2f BB |
31 | #include <sys/errno.h> |
32 | #include <sys/va_list.h> | |
33 | ||
34 | #if defined(_KERNEL) && !defined(_BOOT) | |
35 | #include <sys/kmem.h> | |
36 | #endif | |
37 | ||
38 | #ifdef __cplusplus | |
39 | extern "C" { | |
40 | #endif | |
41 | ||
42 | typedef enum { | |
43 | DATA_TYPE_UNKNOWN = 0, | |
44 | DATA_TYPE_BOOLEAN, | |
45 | DATA_TYPE_BYTE, | |
46 | DATA_TYPE_INT16, | |
47 | DATA_TYPE_UINT16, | |
48 | DATA_TYPE_INT32, | |
49 | DATA_TYPE_UINT32, | |
50 | DATA_TYPE_INT64, | |
51 | DATA_TYPE_UINT64, | |
52 | DATA_TYPE_STRING, | |
53 | DATA_TYPE_BYTE_ARRAY, | |
54 | DATA_TYPE_INT16_ARRAY, | |
55 | DATA_TYPE_UINT16_ARRAY, | |
56 | DATA_TYPE_INT32_ARRAY, | |
57 | DATA_TYPE_UINT32_ARRAY, | |
58 | DATA_TYPE_INT64_ARRAY, | |
59 | DATA_TYPE_UINT64_ARRAY, | |
60 | DATA_TYPE_STRING_ARRAY, | |
61 | DATA_TYPE_HRTIME, | |
62 | DATA_TYPE_NVLIST, | |
63 | DATA_TYPE_NVLIST_ARRAY, | |
64 | DATA_TYPE_BOOLEAN_VALUE, | |
65 | DATA_TYPE_INT8, | |
66 | DATA_TYPE_UINT8, | |
67 | DATA_TYPE_BOOLEAN_ARRAY, | |
68 | DATA_TYPE_INT8_ARRAY, | |
b128c09f BB |
69 | #if !defined(_KERNEL) |
70 | DATA_TYPE_UINT8_ARRAY, | |
71 | DATA_TYPE_DOUBLE | |
72 | #else | |
34dc7c2f | 73 | DATA_TYPE_UINT8_ARRAY |
b128c09f | 74 | #endif |
34dc7c2f BB |
75 | } data_type_t; |
76 | ||
77 | typedef struct nvpair { | |
78 | int32_t nvp_size; /* size of this nvpair */ | |
79 | int16_t nvp_name_sz; /* length of name string */ | |
80 | int16_t nvp_reserve; /* not used */ | |
81 | int32_t nvp_value_elem; /* number of elements for array types */ | |
82 | data_type_t nvp_type; /* type of value */ | |
83 | /* name string */ | |
84 | /* aligned ptr array for string arrays */ | |
85 | /* aligned array of data for value */ | |
86 | } nvpair_t; | |
87 | ||
88 | /* nvlist header */ | |
89 | typedef struct nvlist { | |
90 | int32_t nvl_version; | |
91 | uint32_t nvl_nvflag; /* persistent flags */ | |
92 | uint64_t nvl_priv; /* ptr to private data if not packed */ | |
93 | uint32_t nvl_flag; | |
94 | int32_t nvl_pad; /* currently not used, for alignment */ | |
95 | } nvlist_t; | |
96 | ||
97 | /* nvp implementation version */ | |
98 | #define NV_VERSION 0 | |
99 | ||
100 | /* nvlist pack encoding */ | |
101 | #define NV_ENCODE_NATIVE 0 | |
102 | #define NV_ENCODE_XDR 1 | |
103 | ||
104 | /* nvlist persistent unique name flags, stored in nvl_nvflags */ | |
105 | #define NV_UNIQUE_NAME 0x1 | |
106 | #define NV_UNIQUE_NAME_TYPE 0x2 | |
107 | ||
108 | /* nvlist lookup pairs related flags */ | |
109 | #define NV_FLAG_NOENTOK 0x1 | |
110 | ||
111 | /* convenience macros */ | |
112 | #define NV_ALIGN(x) (((ulong_t)(x) + 7ul) & ~7ul) | |
113 | #define NV_ALIGN4(x) (((x) + 3) & ~3) | |
114 | ||
115 | #define NVP_SIZE(nvp) ((nvp)->nvp_size) | |
116 | #define NVP_NAME(nvp) ((char *)(nvp) + sizeof (nvpair_t)) | |
117 | #define NVP_TYPE(nvp) ((nvp)->nvp_type) | |
118 | #define NVP_NELEM(nvp) ((nvp)->nvp_value_elem) | |
119 | #define NVP_VALUE(nvp) ((char *)(nvp) + NV_ALIGN(sizeof (nvpair_t) \ | |
120 | + (nvp)->nvp_name_sz)) | |
121 | ||
122 | #define NVL_VERSION(nvl) ((nvl)->nvl_version) | |
123 | #define NVL_SIZE(nvl) ((nvl)->nvl_size) | |
124 | #define NVL_FLAG(nvl) ((nvl)->nvl_flag) | |
125 | ||
126 | /* NV allocator framework */ | |
127 | typedef struct nv_alloc_ops nv_alloc_ops_t; | |
128 | ||
129 | typedef struct nv_alloc { | |
130 | const nv_alloc_ops_t *nva_ops; | |
131 | void *nva_arg; | |
132 | } nv_alloc_t; | |
133 | ||
134 | struct nv_alloc_ops { | |
22a11a5b | 135 | int (*nv_ao_init)(nv_alloc_t *, va_list); |
34dc7c2f BB |
136 | void (*nv_ao_fini)(nv_alloc_t *); |
137 | void *(*nv_ao_alloc)(nv_alloc_t *, size_t); | |
138 | void (*nv_ao_free)(nv_alloc_t *, void *, size_t); | |
139 | void (*nv_ao_reset)(nv_alloc_t *); | |
140 | }; | |
141 | ||
142 | extern const nv_alloc_ops_t *nv_fixed_ops; | |
143 | extern nv_alloc_t *nv_alloc_nosleep; | |
144 | ||
145 | #if defined(_KERNEL) && !defined(_BOOT) | |
146 | extern nv_alloc_t *nv_alloc_sleep; | |
81eaf151 | 147 | extern nv_alloc_t *nv_alloc_pushpage; |
34dc7c2f BB |
148 | #endif |
149 | ||
150 | int nv_alloc_init(nv_alloc_t *, const nv_alloc_ops_t *, /* args */ ...); | |
151 | void nv_alloc_reset(nv_alloc_t *); | |
152 | void nv_alloc_fini(nv_alloc_t *); | |
153 | ||
154 | /* list management */ | |
155 | int nvlist_alloc(nvlist_t **, uint_t, int); | |
156 | void nvlist_free(nvlist_t *); | |
157 | int nvlist_size(nvlist_t *, size_t *, int); | |
158 | int nvlist_pack(nvlist_t *, char **, size_t *, int, int); | |
159 | int nvlist_unpack(char *, size_t, nvlist_t **, int); | |
160 | int nvlist_dup(nvlist_t *, nvlist_t **, int); | |
161 | int nvlist_merge(nvlist_t *, nvlist_t *, int); | |
162 | ||
572e2857 BB |
163 | uint_t nvlist_nvflag(nvlist_t *); |
164 | ||
34dc7c2f BB |
165 | int nvlist_xalloc(nvlist_t **, uint_t, nv_alloc_t *); |
166 | int nvlist_xpack(nvlist_t *, char **, size_t *, int, nv_alloc_t *); | |
167 | int nvlist_xunpack(char *, size_t, nvlist_t **, nv_alloc_t *); | |
168 | int nvlist_xdup(nvlist_t *, nvlist_t **, nv_alloc_t *); | |
169 | nv_alloc_t *nvlist_lookup_nv_alloc(nvlist_t *); | |
170 | ||
171 | int nvlist_add_nvpair(nvlist_t *, nvpair_t *); | |
172 | int nvlist_add_boolean(nvlist_t *, const char *); | |
173 | int nvlist_add_boolean_value(nvlist_t *, const char *, boolean_t); | |
174 | int nvlist_add_byte(nvlist_t *, const char *, uchar_t); | |
175 | int nvlist_add_int8(nvlist_t *, const char *, int8_t); | |
176 | int nvlist_add_uint8(nvlist_t *, const char *, uint8_t); | |
177 | int nvlist_add_int16(nvlist_t *, const char *, int16_t); | |
178 | int nvlist_add_uint16(nvlist_t *, const char *, uint16_t); | |
179 | int nvlist_add_int32(nvlist_t *, const char *, int32_t); | |
180 | int nvlist_add_uint32(nvlist_t *, const char *, uint32_t); | |
181 | int nvlist_add_int64(nvlist_t *, const char *, int64_t); | |
182 | int nvlist_add_uint64(nvlist_t *, const char *, uint64_t); | |
183 | int nvlist_add_string(nvlist_t *, const char *, const char *); | |
184 | int nvlist_add_nvlist(nvlist_t *, const char *, nvlist_t *); | |
185 | int nvlist_add_boolean_array(nvlist_t *, const char *, boolean_t *, uint_t); | |
186 | int nvlist_add_byte_array(nvlist_t *, const char *, uchar_t *, uint_t); | |
187 | int nvlist_add_int8_array(nvlist_t *, const char *, int8_t *, uint_t); | |
188 | int nvlist_add_uint8_array(nvlist_t *, const char *, uint8_t *, uint_t); | |
189 | int nvlist_add_int16_array(nvlist_t *, const char *, int16_t *, uint_t); | |
190 | int nvlist_add_uint16_array(nvlist_t *, const char *, uint16_t *, uint_t); | |
191 | int nvlist_add_int32_array(nvlist_t *, const char *, int32_t *, uint_t); | |
192 | int nvlist_add_uint32_array(nvlist_t *, const char *, uint32_t *, uint_t); | |
193 | int nvlist_add_int64_array(nvlist_t *, const char *, int64_t *, uint_t); | |
194 | int nvlist_add_uint64_array(nvlist_t *, const char *, uint64_t *, uint_t); | |
195 | int nvlist_add_string_array(nvlist_t *, const char *, char *const *, uint_t); | |
196 | int nvlist_add_nvlist_array(nvlist_t *, const char *, nvlist_t **, uint_t); | |
197 | int nvlist_add_hrtime(nvlist_t *, const char *, hrtime_t); | |
b128c09f BB |
198 | #if !defined(_KERNEL) |
199 | int nvlist_add_double(nvlist_t *, const char *, double); | |
200 | #endif | |
34dc7c2f BB |
201 | |
202 | int nvlist_remove(nvlist_t *, const char *, data_type_t); | |
203 | int nvlist_remove_all(nvlist_t *, const char *); | |
428870ff | 204 | int nvlist_remove_nvpair(nvlist_t *, nvpair_t *); |
34dc7c2f BB |
205 | |
206 | int nvlist_lookup_boolean(nvlist_t *, const char *); | |
207 | int nvlist_lookup_boolean_value(nvlist_t *, const char *, boolean_t *); | |
208 | int nvlist_lookup_byte(nvlist_t *, const char *, uchar_t *); | |
209 | int nvlist_lookup_int8(nvlist_t *, const char *, int8_t *); | |
210 | int nvlist_lookup_uint8(nvlist_t *, const char *, uint8_t *); | |
211 | int nvlist_lookup_int16(nvlist_t *, const char *, int16_t *); | |
212 | int nvlist_lookup_uint16(nvlist_t *, const char *, uint16_t *); | |
213 | int nvlist_lookup_int32(nvlist_t *, const char *, int32_t *); | |
214 | int nvlist_lookup_uint32(nvlist_t *, const char *, uint32_t *); | |
215 | int nvlist_lookup_int64(nvlist_t *, const char *, int64_t *); | |
216 | int nvlist_lookup_uint64(nvlist_t *, const char *, uint64_t *); | |
217 | int nvlist_lookup_string(nvlist_t *, const char *, char **); | |
218 | int nvlist_lookup_nvlist(nvlist_t *, const char *, nvlist_t **); | |
219 | int nvlist_lookup_boolean_array(nvlist_t *, const char *, | |
220 | boolean_t **, uint_t *); | |
221 | int nvlist_lookup_byte_array(nvlist_t *, const char *, uchar_t **, uint_t *); | |
222 | int nvlist_lookup_int8_array(nvlist_t *, const char *, int8_t **, uint_t *); | |
223 | int nvlist_lookup_uint8_array(nvlist_t *, const char *, uint8_t **, uint_t *); | |
224 | int nvlist_lookup_int16_array(nvlist_t *, const char *, int16_t **, uint_t *); | |
225 | int nvlist_lookup_uint16_array(nvlist_t *, const char *, uint16_t **, uint_t *); | |
226 | int nvlist_lookup_int32_array(nvlist_t *, const char *, int32_t **, uint_t *); | |
227 | int nvlist_lookup_uint32_array(nvlist_t *, const char *, uint32_t **, uint_t *); | |
228 | int nvlist_lookup_int64_array(nvlist_t *, const char *, int64_t **, uint_t *); | |
229 | int nvlist_lookup_uint64_array(nvlist_t *, const char *, uint64_t **, uint_t *); | |
230 | int nvlist_lookup_string_array(nvlist_t *, const char *, char ***, uint_t *); | |
231 | int nvlist_lookup_nvlist_array(nvlist_t *, const char *, | |
232 | nvlist_t ***, uint_t *); | |
233 | int nvlist_lookup_hrtime(nvlist_t *, const char *, hrtime_t *); | |
b128c09f BB |
234 | int nvlist_lookup_pairs(nvlist_t *, int, ...); |
235 | #if !defined(_KERNEL) | |
236 | int nvlist_lookup_double(nvlist_t *, const char *, double *); | |
237 | #endif | |
34dc7c2f | 238 | |
b128c09f BB |
239 | int nvlist_lookup_nvpair(nvlist_t *, const char *, nvpair_t **); |
240 | int nvlist_lookup_nvpair_embedded_index(nvlist_t *, const char *, nvpair_t **, | |
241 | int *, char **); | |
242 | boolean_t nvlist_exists(nvlist_t *, const char *); | |
428870ff | 243 | boolean_t nvlist_empty(nvlist_t *); |
34dc7c2f BB |
244 | |
245 | /* processing nvpair */ | |
b128c09f | 246 | nvpair_t *nvlist_next_nvpair(nvlist_t *, nvpair_t *); |
428870ff | 247 | nvpair_t *nvlist_prev_nvpair(nvlist_t *, nvpair_t *); |
34dc7c2f BB |
248 | char *nvpair_name(nvpair_t *); |
249 | data_type_t nvpair_type(nvpair_t *); | |
b128c09f | 250 | int nvpair_type_is_array(nvpair_t *); |
34dc7c2f BB |
251 | int nvpair_value_boolean_value(nvpair_t *, boolean_t *); |
252 | int nvpair_value_byte(nvpair_t *, uchar_t *); | |
253 | int nvpair_value_int8(nvpair_t *, int8_t *); | |
254 | int nvpair_value_uint8(nvpair_t *, uint8_t *); | |
255 | int nvpair_value_int16(nvpair_t *, int16_t *); | |
256 | int nvpair_value_uint16(nvpair_t *, uint16_t *); | |
257 | int nvpair_value_int32(nvpair_t *, int32_t *); | |
258 | int nvpair_value_uint32(nvpair_t *, uint32_t *); | |
259 | int nvpair_value_int64(nvpair_t *, int64_t *); | |
260 | int nvpair_value_uint64(nvpair_t *, uint64_t *); | |
261 | int nvpair_value_string(nvpair_t *, char **); | |
262 | int nvpair_value_nvlist(nvpair_t *, nvlist_t **); | |
263 | int nvpair_value_boolean_array(nvpair_t *, boolean_t **, uint_t *); | |
264 | int nvpair_value_byte_array(nvpair_t *, uchar_t **, uint_t *); | |
265 | int nvpair_value_int8_array(nvpair_t *, int8_t **, uint_t *); | |
266 | int nvpair_value_uint8_array(nvpair_t *, uint8_t **, uint_t *); | |
267 | int nvpair_value_int16_array(nvpair_t *, int16_t **, uint_t *); | |
268 | int nvpair_value_uint16_array(nvpair_t *, uint16_t **, uint_t *); | |
269 | int nvpair_value_int32_array(nvpair_t *, int32_t **, uint_t *); | |
270 | int nvpair_value_uint32_array(nvpair_t *, uint32_t **, uint_t *); | |
271 | int nvpair_value_int64_array(nvpair_t *, int64_t **, uint_t *); | |
272 | int nvpair_value_uint64_array(nvpair_t *, uint64_t **, uint_t *); | |
273 | int nvpair_value_string_array(nvpair_t *, char ***, uint_t *); | |
274 | int nvpair_value_nvlist_array(nvpair_t *, nvlist_t ***, uint_t *); | |
275 | int nvpair_value_hrtime(nvpair_t *, hrtime_t *); | |
b128c09f BB |
276 | #if !defined(_KERNEL) |
277 | int nvpair_value_double(nvpair_t *, double *); | |
278 | #endif | |
34dc7c2f | 279 | |
9ae529ec CS |
280 | nvlist_t *fnvlist_alloc(void); |
281 | void fnvlist_free(nvlist_t *); | |
282 | size_t fnvlist_size(nvlist_t *); | |
283 | char *fnvlist_pack(nvlist_t *, size_t *); | |
284 | void fnvlist_pack_free(char *, size_t); | |
285 | nvlist_t *fnvlist_unpack(char *, size_t); | |
286 | nvlist_t *fnvlist_dup(nvlist_t *); | |
287 | void fnvlist_merge(nvlist_t *, nvlist_t *); | |
13fe0198 | 288 | size_t fnvlist_num_pairs(nvlist_t *); |
9ae529ec CS |
289 | |
290 | void fnvlist_add_boolean(nvlist_t *, const char *); | |
291 | void fnvlist_add_boolean_value(nvlist_t *, const char *, boolean_t); | |
292 | void fnvlist_add_byte(nvlist_t *, const char *, uchar_t); | |
293 | void fnvlist_add_int8(nvlist_t *, const char *, int8_t); | |
294 | void fnvlist_add_uint8(nvlist_t *, const char *, uint8_t); | |
295 | void fnvlist_add_int16(nvlist_t *, const char *, int16_t); | |
296 | void fnvlist_add_uint16(nvlist_t *, const char *, uint16_t); | |
297 | void fnvlist_add_int32(nvlist_t *, const char *, int32_t); | |
298 | void fnvlist_add_uint32(nvlist_t *, const char *, uint32_t); | |
299 | void fnvlist_add_int64(nvlist_t *, const char *, int64_t); | |
300 | void fnvlist_add_uint64(nvlist_t *, const char *, uint64_t); | |
301 | void fnvlist_add_string(nvlist_t *, const char *, const char *); | |
302 | void fnvlist_add_nvlist(nvlist_t *, const char *, nvlist_t *); | |
303 | void fnvlist_add_nvpair(nvlist_t *, nvpair_t *); | |
304 | void fnvlist_add_boolean_array(nvlist_t *, const char *, boolean_t *, uint_t); | |
305 | void fnvlist_add_byte_array(nvlist_t *, const char *, uchar_t *, uint_t); | |
306 | void fnvlist_add_int8_array(nvlist_t *, const char *, int8_t *, uint_t); | |
307 | void fnvlist_add_uint8_array(nvlist_t *, const char *, uint8_t *, uint_t); | |
308 | void fnvlist_add_int16_array(nvlist_t *, const char *, int16_t *, uint_t); | |
309 | void fnvlist_add_uint16_array(nvlist_t *, const char *, uint16_t *, uint_t); | |
310 | void fnvlist_add_int32_array(nvlist_t *, const char *, int32_t *, uint_t); | |
311 | void fnvlist_add_uint32_array(nvlist_t *, const char *, uint32_t *, uint_t); | |
312 | void fnvlist_add_int64_array(nvlist_t *, const char *, int64_t *, uint_t); | |
313 | void fnvlist_add_uint64_array(nvlist_t *, const char *, uint64_t *, uint_t); | |
314 | void fnvlist_add_string_array(nvlist_t *, const char *, char * const *, uint_t); | |
315 | void fnvlist_add_nvlist_array(nvlist_t *, const char *, nvlist_t **, uint_t); | |
316 | ||
317 | void fnvlist_remove(nvlist_t *, const char *); | |
318 | void fnvlist_remove_nvpair(nvlist_t *, nvpair_t *); | |
319 | ||
320 | nvpair_t *fnvlist_lookup_nvpair(nvlist_t *nvl, const char *name); | |
321 | boolean_t fnvlist_lookup_boolean(nvlist_t *nvl, const char *name); | |
322 | boolean_t fnvlist_lookup_boolean_value(nvlist_t *nvl, const char *name); | |
323 | uchar_t fnvlist_lookup_byte(nvlist_t *nvl, const char *name); | |
324 | int8_t fnvlist_lookup_int8(nvlist_t *nvl, const char *name); | |
325 | int16_t fnvlist_lookup_int16(nvlist_t *nvl, const char *name); | |
326 | int32_t fnvlist_lookup_int32(nvlist_t *nvl, const char *name); | |
327 | int64_t fnvlist_lookup_int64(nvlist_t *nvl, const char *name); | |
328 | uint8_t fnvlist_lookup_uint8(nvlist_t *nvl, const char *name); | |
329 | uint16_t fnvlist_lookup_uint16(nvlist_t *nvl, const char *name); | |
330 | uint32_t fnvlist_lookup_uint32(nvlist_t *nvl, const char *name); | |
331 | uint64_t fnvlist_lookup_uint64(nvlist_t *nvl, const char *name); | |
332 | char *fnvlist_lookup_string(nvlist_t *nvl, const char *name); | |
333 | nvlist_t *fnvlist_lookup_nvlist(nvlist_t *nvl, const char *name); | |
334 | ||
335 | boolean_t fnvpair_value_boolean_value(nvpair_t *nvp); | |
336 | uchar_t fnvpair_value_byte(nvpair_t *nvp); | |
337 | int8_t fnvpair_value_int8(nvpair_t *nvp); | |
338 | int16_t fnvpair_value_int16(nvpair_t *nvp); | |
339 | int32_t fnvpair_value_int32(nvpair_t *nvp); | |
340 | int64_t fnvpair_value_int64(nvpair_t *nvp); | |
341 | uint8_t fnvpair_value_uint8(nvpair_t *nvp); | |
342 | uint16_t fnvpair_value_uint16(nvpair_t *nvp); | |
343 | uint32_t fnvpair_value_uint32(nvpair_t *nvp); | |
344 | uint64_t fnvpair_value_uint64(nvpair_t *nvp); | |
345 | char *fnvpair_value_string(nvpair_t *nvp); | |
346 | nvlist_t *fnvpair_value_nvlist(nvpair_t *nvp); | |
347 | ||
34dc7c2f BB |
348 | #ifdef __cplusplus |
349 | } | |
350 | #endif | |
351 | ||
352 | #endif /* _SYS_NVPAIR_H */ |