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.
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.
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]
23 * Copyright (c) 2012 by Delphix. All rights reserved.
26 #include <sys/nvpair.h>
28 #include <sys/debug.h>
34 * "Force" nvlist wrapper.
36 * These functions wrap the nvlist_* functions with assertions that assume
37 * the operation is successful. This allows the caller's code to be much
38 * more readable, especially for the fnvlist_lookup_* and fnvpair_value_*
39 * functions, which can return the requested value (rather than filling in
42 * These functions use NV_UNIQUE_NAME, encoding NV_ENCODE_NATIVE, and allocate
45 * More wrappers should be added as needed -- for example
46 * nvlist_lookup_*_array and nvpair_value_*_array.
53 VERIFY0(nvlist_alloc(&nvl
, NV_UNIQUE_NAME
, KM_SLEEP
));
58 fnvlist_free(nvlist_t
*nvl
)
64 fnvlist_size(nvlist_t
*nvl
)
67 VERIFY0(nvlist_size(nvl
, &size
, NV_ENCODE_NATIVE
));
72 * Returns allocated buffer of size *sizep. Caller must free the buffer with
73 * fnvlist_pack_free().
76 fnvlist_pack(nvlist_t
*nvl
, size_t *sizep
)
79 VERIFY3U(nvlist_pack(nvl
, &packed
, sizep
, NV_ENCODE_NATIVE
,
86 fnvlist_pack_free(char *pack
, size_t size
)
89 kmem_free(pack
, size
);
96 fnvlist_unpack(char *buf
, size_t buflen
)
99 VERIFY0(nvlist_unpack(buf
, buflen
, &rv
, KM_SLEEP
));
104 fnvlist_dup(nvlist_t
*nvl
)
107 VERIFY0(nvlist_dup(nvl
, &rv
, KM_SLEEP
));
112 fnvlist_merge(nvlist_t
*dst
, nvlist_t
*src
)
114 VERIFY0(nvlist_merge(dst
, src
, KM_SLEEP
));
118 fnvlist_add_boolean(nvlist_t
*nvl
, const char *name
)
120 VERIFY0(nvlist_add_boolean(nvl
, name
));
124 fnvlist_add_boolean_value(nvlist_t
*nvl
, const char *name
, boolean_t val
)
126 VERIFY0(nvlist_add_boolean_value(nvl
, name
, val
));
130 fnvlist_add_byte(nvlist_t
*nvl
, const char *name
, uchar_t val
)
132 VERIFY0(nvlist_add_byte(nvl
, name
, val
));
136 fnvlist_add_int8(nvlist_t
*nvl
, const char *name
, int8_t val
)
138 VERIFY0(nvlist_add_int8(nvl
, name
, val
));
142 fnvlist_add_uint8(nvlist_t
*nvl
, const char *name
, uint8_t val
)
144 VERIFY0(nvlist_add_uint8(nvl
, name
, val
));
148 fnvlist_add_int16(nvlist_t
*nvl
, const char *name
, int16_t val
)
150 VERIFY0(nvlist_add_int16(nvl
, name
, val
));
154 fnvlist_add_uint16(nvlist_t
*nvl
, const char *name
, uint16_t val
)
156 VERIFY0(nvlist_add_uint16(nvl
, name
, val
));
160 fnvlist_add_int32(nvlist_t
*nvl
, const char *name
, int32_t val
)
162 VERIFY0(nvlist_add_int32(nvl
, name
, val
));
166 fnvlist_add_uint32(nvlist_t
*nvl
, const char *name
, uint32_t val
)
168 VERIFY0(nvlist_add_uint32(nvl
, name
, val
));
172 fnvlist_add_int64(nvlist_t
*nvl
, const char *name
, int64_t val
)
174 VERIFY0(nvlist_add_int64(nvl
, name
, val
));
178 fnvlist_add_uint64(nvlist_t
*nvl
, const char *name
, uint64_t val
)
180 VERIFY0(nvlist_add_uint64(nvl
, name
, val
));
184 fnvlist_add_string(nvlist_t
*nvl
, const char *name
, const char *val
)
186 VERIFY0(nvlist_add_string(nvl
, name
, val
));
190 fnvlist_add_nvlist(nvlist_t
*nvl
, const char *name
, nvlist_t
*val
)
192 VERIFY0(nvlist_add_nvlist(nvl
, name
, val
));
196 fnvlist_add_nvpair(nvlist_t
*nvl
, nvpair_t
*pair
)
198 VERIFY0(nvlist_add_nvpair(nvl
, pair
));
202 fnvlist_add_boolean_array(nvlist_t
*nvl
, const char *name
,
203 boolean_t
*val
, uint_t n
)
205 VERIFY0(nvlist_add_boolean_array(nvl
, name
, val
, n
));
209 fnvlist_add_byte_array(nvlist_t
*nvl
, const char *name
, uchar_t
*val
, uint_t n
)
211 VERIFY0(nvlist_add_byte_array(nvl
, name
, val
, n
));
215 fnvlist_add_int8_array(nvlist_t
*nvl
, const char *name
, int8_t *val
, uint_t n
)
217 VERIFY0(nvlist_add_int8_array(nvl
, name
, val
, n
));
221 fnvlist_add_uint8_array(nvlist_t
*nvl
, const char *name
, uint8_t *val
, uint_t n
)
223 VERIFY0(nvlist_add_uint8_array(nvl
, name
, val
, n
));
227 fnvlist_add_int16_array(nvlist_t
*nvl
, const char *name
, int16_t *val
, uint_t n
)
229 VERIFY0(nvlist_add_int16_array(nvl
, name
, val
, n
));
233 fnvlist_add_uint16_array(nvlist_t
*nvl
, const char *name
,
234 uint16_t *val
, uint_t n
)
236 VERIFY0(nvlist_add_uint16_array(nvl
, name
, val
, n
));
240 fnvlist_add_int32_array(nvlist_t
*nvl
, const char *name
, int32_t *val
, uint_t n
)
242 VERIFY0(nvlist_add_int32_array(nvl
, name
, val
, n
));
246 fnvlist_add_uint32_array(nvlist_t
*nvl
, const char *name
,
247 uint32_t *val
, uint_t n
)
249 VERIFY0(nvlist_add_uint32_array(nvl
, name
, val
, n
));
253 fnvlist_add_int64_array(nvlist_t
*nvl
, const char *name
, int64_t *val
, uint_t n
)
255 VERIFY0(nvlist_add_int64_array(nvl
, name
, val
, n
));
259 fnvlist_add_uint64_array(nvlist_t
*nvl
, const char *name
,
260 uint64_t *val
, uint_t n
)
262 VERIFY0(nvlist_add_uint64_array(nvl
, name
, val
, n
));
266 fnvlist_add_string_array(nvlist_t
*nvl
, const char *name
,
267 char * const *val
, uint_t n
)
269 VERIFY0(nvlist_add_string_array(nvl
, name
, val
, n
));
273 fnvlist_add_nvlist_array(nvlist_t
*nvl
, const char *name
,
274 nvlist_t
**val
, uint_t n
)
276 VERIFY0(nvlist_add_nvlist_array(nvl
, name
, val
, n
));
280 fnvlist_remove(nvlist_t
*nvl
, const char *name
)
282 VERIFY0(nvlist_remove_all(nvl
, name
));
286 fnvlist_remove_nvpair(nvlist_t
*nvl
, nvpair_t
*pair
)
288 VERIFY0(nvlist_remove_nvpair(nvl
, pair
));
292 fnvlist_lookup_nvpair(nvlist_t
*nvl
, const char *name
)
295 VERIFY0(nvlist_lookup_nvpair(nvl
, name
, &rv
));
299 /* returns B_TRUE if the entry exists */
301 fnvlist_lookup_boolean(nvlist_t
*nvl
, const char *name
)
303 return (nvlist_lookup_boolean(nvl
, name
) == 0);
307 fnvlist_lookup_boolean_value(nvlist_t
*nvl
, const char *name
)
310 VERIFY0(nvlist_lookup_boolean_value(nvl
, name
, &rv
));
315 fnvlist_lookup_byte(nvlist_t
*nvl
, const char *name
)
318 VERIFY0(nvlist_lookup_byte(nvl
, name
, &rv
));
323 fnvlist_lookup_int8(nvlist_t
*nvl
, const char *name
)
326 VERIFY0(nvlist_lookup_int8(nvl
, name
, &rv
));
331 fnvlist_lookup_int16(nvlist_t
*nvl
, const char *name
)
334 VERIFY0(nvlist_lookup_int16(nvl
, name
, &rv
));
339 fnvlist_lookup_int32(nvlist_t
*nvl
, const char *name
)
342 VERIFY0(nvlist_lookup_int32(nvl
, name
, &rv
));
347 fnvlist_lookup_int64(nvlist_t
*nvl
, const char *name
)
350 VERIFY0(nvlist_lookup_int64(nvl
, name
, &rv
));
355 fnvlist_lookup_uint8(nvlist_t
*nvl
, const char *name
)
358 VERIFY0(nvlist_lookup_uint8(nvl
, name
, &rv
));
363 fnvlist_lookup_uint16(nvlist_t
*nvl
, const char *name
)
366 VERIFY0(nvlist_lookup_uint16(nvl
, name
, &rv
));
371 fnvlist_lookup_uint32(nvlist_t
*nvl
, const char *name
)
374 VERIFY0(nvlist_lookup_uint32(nvl
, name
, &rv
));
379 fnvlist_lookup_uint64(nvlist_t
*nvl
, const char *name
)
382 VERIFY0(nvlist_lookup_uint64(nvl
, name
, &rv
));
387 fnvlist_lookup_string(nvlist_t
*nvl
, const char *name
)
390 VERIFY0(nvlist_lookup_string(nvl
, name
, &rv
));
395 fnvlist_lookup_nvlist(nvlist_t
*nvl
, const char *name
)
398 VERIFY0(nvlist_lookup_nvlist(nvl
, name
, &rv
));
403 fnvpair_value_boolean_value(nvpair_t
*nvp
)
406 VERIFY0(nvpair_value_boolean_value(nvp
, &rv
));
411 fnvpair_value_byte(nvpair_t
*nvp
)
414 VERIFY0(nvpair_value_byte(nvp
, &rv
));
419 fnvpair_value_int8(nvpair_t
*nvp
)
422 VERIFY0(nvpair_value_int8(nvp
, &rv
));
427 fnvpair_value_int16(nvpair_t
*nvp
)
430 VERIFY0(nvpair_value_int16(nvp
, &rv
));
435 fnvpair_value_int32(nvpair_t
*nvp
)
438 VERIFY0(nvpair_value_int32(nvp
, &rv
));
443 fnvpair_value_int64(nvpair_t
*nvp
)
446 VERIFY0(nvpair_value_int64(nvp
, &rv
));
451 fnvpair_value_uint8(nvpair_t
*nvp
)
454 VERIFY0(nvpair_value_uint8(nvp
, &rv
));
459 fnvpair_value_uint16(nvpair_t
*nvp
)
462 VERIFY0(nvpair_value_uint16(nvp
, &rv
));
467 fnvpair_value_uint32(nvpair_t
*nvp
)
470 VERIFY0(nvpair_value_uint32(nvp
, &rv
));
475 fnvpair_value_uint64(nvpair_t
*nvp
)
478 VERIFY0(nvpair_value_uint64(nvp
, &rv
));
483 fnvpair_value_string(nvpair_t
*nvp
)
486 VERIFY0(nvpair_value_string(nvp
, &rv
));
491 fnvpair_value_nvlist(nvpair_t
*nvp
)
494 VERIFY0(nvpair_value_nvlist(nvp
, &rv
));
498 #if defined(_KERNEL) && defined(HAVE_SPL)
500 EXPORT_SYMBOL(fnvlist_alloc
);
501 EXPORT_SYMBOL(fnvlist_free
);
502 EXPORT_SYMBOL(fnvlist_size
);
503 EXPORT_SYMBOL(fnvlist_pack
);
504 EXPORT_SYMBOL(fnvlist_pack_free
);
505 EXPORT_SYMBOL(fnvlist_unpack
);
506 EXPORT_SYMBOL(fnvlist_dup
);
507 EXPORT_SYMBOL(fnvlist_merge
);
509 EXPORT_SYMBOL(fnvlist_add_nvpair
);
510 EXPORT_SYMBOL(fnvlist_add_boolean
);
511 EXPORT_SYMBOL(fnvlist_add_boolean_value
);
512 EXPORT_SYMBOL(fnvlist_add_byte
);
513 EXPORT_SYMBOL(fnvlist_add_int8
);
514 EXPORT_SYMBOL(fnvlist_add_uint8
);
515 EXPORT_SYMBOL(fnvlist_add_int16
);
516 EXPORT_SYMBOL(fnvlist_add_uint16
);
517 EXPORT_SYMBOL(fnvlist_add_int32
);
518 EXPORT_SYMBOL(fnvlist_add_uint32
);
519 EXPORT_SYMBOL(fnvlist_add_int64
);
520 EXPORT_SYMBOL(fnvlist_add_uint64
);
521 EXPORT_SYMBOL(fnvlist_add_string
);
522 EXPORT_SYMBOL(fnvlist_add_nvlist
);
523 EXPORT_SYMBOL(fnvlist_add_boolean_array
);
524 EXPORT_SYMBOL(fnvlist_add_byte_array
);
525 EXPORT_SYMBOL(fnvlist_add_int8_array
);
526 EXPORT_SYMBOL(fnvlist_add_uint8_array
);
527 EXPORT_SYMBOL(fnvlist_add_int16_array
);
528 EXPORT_SYMBOL(fnvlist_add_uint16_array
);
529 EXPORT_SYMBOL(fnvlist_add_int32_array
);
530 EXPORT_SYMBOL(fnvlist_add_uint32_array
);
531 EXPORT_SYMBOL(fnvlist_add_int64_array
);
532 EXPORT_SYMBOL(fnvlist_add_uint64_array
);
533 EXPORT_SYMBOL(fnvlist_add_string_array
);
534 EXPORT_SYMBOL(fnvlist_add_nvlist_array
);
536 EXPORT_SYMBOL(fnvlist_remove
);
537 EXPORT_SYMBOL(fnvlist_remove_nvpair
);
539 EXPORT_SYMBOL(fnvlist_lookup_nvpair
);
540 EXPORT_SYMBOL(fnvlist_lookup_boolean
);
541 EXPORT_SYMBOL(fnvlist_lookup_boolean_value
);
542 EXPORT_SYMBOL(fnvlist_lookup_byte
);
543 EXPORT_SYMBOL(fnvlist_lookup_int8
);
544 EXPORT_SYMBOL(fnvlist_lookup_uint8
);
545 EXPORT_SYMBOL(fnvlist_lookup_int16
);
546 EXPORT_SYMBOL(fnvlist_lookup_uint16
);
547 EXPORT_SYMBOL(fnvlist_lookup_int32
);
548 EXPORT_SYMBOL(fnvlist_lookup_uint32
);
549 EXPORT_SYMBOL(fnvlist_lookup_int64
);
550 EXPORT_SYMBOL(fnvlist_lookup_uint64
);
551 EXPORT_SYMBOL(fnvlist_lookup_string
);
552 EXPORT_SYMBOL(fnvlist_lookup_nvlist
);
554 EXPORT_SYMBOL(fnvpair_value_boolean_value
);
555 EXPORT_SYMBOL(fnvpair_value_byte
);
556 EXPORT_SYMBOL(fnvpair_value_int8
);
557 EXPORT_SYMBOL(fnvpair_value_uint8
);
558 EXPORT_SYMBOL(fnvpair_value_int16
);
559 EXPORT_SYMBOL(fnvpair_value_uint16
);
560 EXPORT_SYMBOL(fnvpair_value_int32
);
561 EXPORT_SYMBOL(fnvpair_value_uint32
);
562 EXPORT_SYMBOL(fnvpair_value_int64
);
563 EXPORT_SYMBOL(fnvpair_value_uint64
);
564 EXPORT_SYMBOL(fnvpair_value_string
);
565 EXPORT_SYMBOL(fnvpair_value_nvlist
);