]> git.proxmox.com Git - mirror_zfs-debian.git/blame - module/nvpair/include/sys/nvpair.h
Update to onnv_147
[mirror_zfs-debian.git] / module / nvpair / include / sys / nvpair.h
CommitLineData
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.
34dc7c2f
BB
23 */
24
25#ifndef _SYS_NVPAIR_H
26#define _SYS_NVPAIR_H
27
34dc7c2f
BB
28#include <sys/types.h>
29#include <sys/errno.h>
30#include <sys/va_list.h>
31
32#if defined(_KERNEL) && !defined(_BOOT)
33#include <sys/kmem.h>
34#endif
35
36#ifdef __cplusplus
37extern "C" {
38#endif
39
40typedef enum {
41 DATA_TYPE_UNKNOWN = 0,
42 DATA_TYPE_BOOLEAN,
43 DATA_TYPE_BYTE,
44 DATA_TYPE_INT16,
45 DATA_TYPE_UINT16,
46 DATA_TYPE_INT32,
47 DATA_TYPE_UINT32,
48 DATA_TYPE_INT64,
49 DATA_TYPE_UINT64,
50 DATA_TYPE_STRING,
51 DATA_TYPE_BYTE_ARRAY,
52 DATA_TYPE_INT16_ARRAY,
53 DATA_TYPE_UINT16_ARRAY,
54 DATA_TYPE_INT32_ARRAY,
55 DATA_TYPE_UINT32_ARRAY,
56 DATA_TYPE_INT64_ARRAY,
57 DATA_TYPE_UINT64_ARRAY,
58 DATA_TYPE_STRING_ARRAY,
59 DATA_TYPE_HRTIME,
60 DATA_TYPE_NVLIST,
61 DATA_TYPE_NVLIST_ARRAY,
62 DATA_TYPE_BOOLEAN_VALUE,
63 DATA_TYPE_INT8,
64 DATA_TYPE_UINT8,
65 DATA_TYPE_BOOLEAN_ARRAY,
66 DATA_TYPE_INT8_ARRAY,
b128c09f
BB
67#if !defined(_KERNEL)
68 DATA_TYPE_UINT8_ARRAY,
69 DATA_TYPE_DOUBLE
70#else
34dc7c2f 71 DATA_TYPE_UINT8_ARRAY
b128c09f 72#endif
34dc7c2f
BB
73} data_type_t;
74
75typedef struct nvpair {
76 int32_t nvp_size; /* size of this nvpair */
77 int16_t nvp_name_sz; /* length of name string */
78 int16_t nvp_reserve; /* not used */
79 int32_t nvp_value_elem; /* number of elements for array types */
80 data_type_t nvp_type; /* type of value */
81 /* name string */
82 /* aligned ptr array for string arrays */
83 /* aligned array of data for value */
84} nvpair_t;
85
86/* nvlist header */
87typedef struct nvlist {
88 int32_t nvl_version;
89 uint32_t nvl_nvflag; /* persistent flags */
90 uint64_t nvl_priv; /* ptr to private data if not packed */
91 uint32_t nvl_flag;
92 int32_t nvl_pad; /* currently not used, for alignment */
93} nvlist_t;
94
95/* nvp implementation version */
96#define NV_VERSION 0
97
98/* nvlist pack encoding */
99#define NV_ENCODE_NATIVE 0
100#define NV_ENCODE_XDR 1
101
102/* nvlist persistent unique name flags, stored in nvl_nvflags */
103#define NV_UNIQUE_NAME 0x1
104#define NV_UNIQUE_NAME_TYPE 0x2
105
106/* nvlist lookup pairs related flags */
107#define NV_FLAG_NOENTOK 0x1
108
109/* convenience macros */
110#define NV_ALIGN(x) (((ulong_t)(x) + 7ul) & ~7ul)
111#define NV_ALIGN4(x) (((x) + 3) & ~3)
112
113#define NVP_SIZE(nvp) ((nvp)->nvp_size)
114#define NVP_NAME(nvp) ((char *)(nvp) + sizeof (nvpair_t))
115#define NVP_TYPE(nvp) ((nvp)->nvp_type)
116#define NVP_NELEM(nvp) ((nvp)->nvp_value_elem)
117#define NVP_VALUE(nvp) ((char *)(nvp) + NV_ALIGN(sizeof (nvpair_t) \
118 + (nvp)->nvp_name_sz))
119
120#define NVL_VERSION(nvl) ((nvl)->nvl_version)
121#define NVL_SIZE(nvl) ((nvl)->nvl_size)
122#define NVL_FLAG(nvl) ((nvl)->nvl_flag)
123
124/* NV allocator framework */
125typedef struct nv_alloc_ops nv_alloc_ops_t;
126
127typedef struct nv_alloc {
128 const nv_alloc_ops_t *nva_ops;
129 void *nva_arg;
130} nv_alloc_t;
131
132struct nv_alloc_ops {
133 int (*nv_ao_init)(nv_alloc_t *, __va_list);
134 void (*nv_ao_fini)(nv_alloc_t *);
135 void *(*nv_ao_alloc)(nv_alloc_t *, size_t);
136 void (*nv_ao_free)(nv_alloc_t *, void *, size_t);
137 void (*nv_ao_reset)(nv_alloc_t *);
138};
139
140extern const nv_alloc_ops_t *nv_fixed_ops;
141extern nv_alloc_t *nv_alloc_nosleep;
142
143#if defined(_KERNEL) && !defined(_BOOT)
144extern nv_alloc_t *nv_alloc_sleep;
145#endif
146
147int nv_alloc_init(nv_alloc_t *, const nv_alloc_ops_t *, /* args */ ...);
148void nv_alloc_reset(nv_alloc_t *);
149void nv_alloc_fini(nv_alloc_t *);
150
151/* list management */
152int nvlist_alloc(nvlist_t **, uint_t, int);
153void nvlist_free(nvlist_t *);
154int nvlist_size(nvlist_t *, size_t *, int);
155int nvlist_pack(nvlist_t *, char **, size_t *, int, int);
156int nvlist_unpack(char *, size_t, nvlist_t **, int);
157int nvlist_dup(nvlist_t *, nvlist_t **, int);
158int nvlist_merge(nvlist_t *, nvlist_t *, int);
159
572e2857
BB
160uint_t nvlist_nvflag(nvlist_t *);
161
34dc7c2f
BB
162int nvlist_xalloc(nvlist_t **, uint_t, nv_alloc_t *);
163int nvlist_xpack(nvlist_t *, char **, size_t *, int, nv_alloc_t *);
164int nvlist_xunpack(char *, size_t, nvlist_t **, nv_alloc_t *);
165int nvlist_xdup(nvlist_t *, nvlist_t **, nv_alloc_t *);
166nv_alloc_t *nvlist_lookup_nv_alloc(nvlist_t *);
167
168int nvlist_add_nvpair(nvlist_t *, nvpair_t *);
169int nvlist_add_boolean(nvlist_t *, const char *);
170int nvlist_add_boolean_value(nvlist_t *, const char *, boolean_t);
171int nvlist_add_byte(nvlist_t *, const char *, uchar_t);
172int nvlist_add_int8(nvlist_t *, const char *, int8_t);
173int nvlist_add_uint8(nvlist_t *, const char *, uint8_t);
174int nvlist_add_int16(nvlist_t *, const char *, int16_t);
175int nvlist_add_uint16(nvlist_t *, const char *, uint16_t);
176int nvlist_add_int32(nvlist_t *, const char *, int32_t);
177int nvlist_add_uint32(nvlist_t *, const char *, uint32_t);
178int nvlist_add_int64(nvlist_t *, const char *, int64_t);
179int nvlist_add_uint64(nvlist_t *, const char *, uint64_t);
180int nvlist_add_string(nvlist_t *, const char *, const char *);
181int nvlist_add_nvlist(nvlist_t *, const char *, nvlist_t *);
182int nvlist_add_boolean_array(nvlist_t *, const char *, boolean_t *, uint_t);
183int nvlist_add_byte_array(nvlist_t *, const char *, uchar_t *, uint_t);
184int nvlist_add_int8_array(nvlist_t *, const char *, int8_t *, uint_t);
185int nvlist_add_uint8_array(nvlist_t *, const char *, uint8_t *, uint_t);
186int nvlist_add_int16_array(nvlist_t *, const char *, int16_t *, uint_t);
187int nvlist_add_uint16_array(nvlist_t *, const char *, uint16_t *, uint_t);
188int nvlist_add_int32_array(nvlist_t *, const char *, int32_t *, uint_t);
189int nvlist_add_uint32_array(nvlist_t *, const char *, uint32_t *, uint_t);
190int nvlist_add_int64_array(nvlist_t *, const char *, int64_t *, uint_t);
191int nvlist_add_uint64_array(nvlist_t *, const char *, uint64_t *, uint_t);
192int nvlist_add_string_array(nvlist_t *, const char *, char *const *, uint_t);
193int nvlist_add_nvlist_array(nvlist_t *, const char *, nvlist_t **, uint_t);
194int nvlist_add_hrtime(nvlist_t *, const char *, hrtime_t);
b128c09f
BB
195#if !defined(_KERNEL)
196int nvlist_add_double(nvlist_t *, const char *, double);
197#endif
34dc7c2f
BB
198
199int nvlist_remove(nvlist_t *, const char *, data_type_t);
200int nvlist_remove_all(nvlist_t *, const char *);
428870ff 201int nvlist_remove_nvpair(nvlist_t *, nvpair_t *);
34dc7c2f
BB
202
203int nvlist_lookup_boolean(nvlist_t *, const char *);
204int nvlist_lookup_boolean_value(nvlist_t *, const char *, boolean_t *);
205int nvlist_lookup_byte(nvlist_t *, const char *, uchar_t *);
206int nvlist_lookup_int8(nvlist_t *, const char *, int8_t *);
207int nvlist_lookup_uint8(nvlist_t *, const char *, uint8_t *);
208int nvlist_lookup_int16(nvlist_t *, const char *, int16_t *);
209int nvlist_lookup_uint16(nvlist_t *, const char *, uint16_t *);
210int nvlist_lookup_int32(nvlist_t *, const char *, int32_t *);
211int nvlist_lookup_uint32(nvlist_t *, const char *, uint32_t *);
212int nvlist_lookup_int64(nvlist_t *, const char *, int64_t *);
213int nvlist_lookup_uint64(nvlist_t *, const char *, uint64_t *);
214int nvlist_lookup_string(nvlist_t *, const char *, char **);
215int nvlist_lookup_nvlist(nvlist_t *, const char *, nvlist_t **);
216int nvlist_lookup_boolean_array(nvlist_t *, const char *,
217 boolean_t **, uint_t *);
218int nvlist_lookup_byte_array(nvlist_t *, const char *, uchar_t **, uint_t *);
219int nvlist_lookup_int8_array(nvlist_t *, const char *, int8_t **, uint_t *);
220int nvlist_lookup_uint8_array(nvlist_t *, const char *, uint8_t **, uint_t *);
221int nvlist_lookup_int16_array(nvlist_t *, const char *, int16_t **, uint_t *);
222int nvlist_lookup_uint16_array(nvlist_t *, const char *, uint16_t **, uint_t *);
223int nvlist_lookup_int32_array(nvlist_t *, const char *, int32_t **, uint_t *);
224int nvlist_lookup_uint32_array(nvlist_t *, const char *, uint32_t **, uint_t *);
225int nvlist_lookup_int64_array(nvlist_t *, const char *, int64_t **, uint_t *);
226int nvlist_lookup_uint64_array(nvlist_t *, const char *, uint64_t **, uint_t *);
227int nvlist_lookup_string_array(nvlist_t *, const char *, char ***, uint_t *);
228int nvlist_lookup_nvlist_array(nvlist_t *, const char *,
229 nvlist_t ***, uint_t *);
230int nvlist_lookup_hrtime(nvlist_t *, const char *, hrtime_t *);
b128c09f
BB
231int nvlist_lookup_pairs(nvlist_t *, int, ...);
232#if !defined(_KERNEL)
233int nvlist_lookup_double(nvlist_t *, const char *, double *);
234#endif
34dc7c2f 235
b128c09f
BB
236int nvlist_lookup_nvpair(nvlist_t *, const char *, nvpair_t **);
237int nvlist_lookup_nvpair_embedded_index(nvlist_t *, const char *, nvpair_t **,
238 int *, char **);
239boolean_t nvlist_exists(nvlist_t *, const char *);
428870ff 240boolean_t nvlist_empty(nvlist_t *);
34dc7c2f
BB
241
242/* processing nvpair */
b128c09f 243nvpair_t *nvlist_next_nvpair(nvlist_t *, nvpair_t *);
428870ff 244nvpair_t *nvlist_prev_nvpair(nvlist_t *, nvpair_t *);
34dc7c2f
BB
245char *nvpair_name(nvpair_t *);
246data_type_t nvpair_type(nvpair_t *);
b128c09f 247int nvpair_type_is_array(nvpair_t *);
34dc7c2f
BB
248int nvpair_value_boolean_value(nvpair_t *, boolean_t *);
249int nvpair_value_byte(nvpair_t *, uchar_t *);
250int nvpair_value_int8(nvpair_t *, int8_t *);
251int nvpair_value_uint8(nvpair_t *, uint8_t *);
252int nvpair_value_int16(nvpair_t *, int16_t *);
253int nvpair_value_uint16(nvpair_t *, uint16_t *);
254int nvpair_value_int32(nvpair_t *, int32_t *);
255int nvpair_value_uint32(nvpair_t *, uint32_t *);
256int nvpair_value_int64(nvpair_t *, int64_t *);
257int nvpair_value_uint64(nvpair_t *, uint64_t *);
258int nvpair_value_string(nvpair_t *, char **);
259int nvpair_value_nvlist(nvpair_t *, nvlist_t **);
260int nvpair_value_boolean_array(nvpair_t *, boolean_t **, uint_t *);
261int nvpair_value_byte_array(nvpair_t *, uchar_t **, uint_t *);
262int nvpair_value_int8_array(nvpair_t *, int8_t **, uint_t *);
263int nvpair_value_uint8_array(nvpair_t *, uint8_t **, uint_t *);
264int nvpair_value_int16_array(nvpair_t *, int16_t **, uint_t *);
265int nvpair_value_uint16_array(nvpair_t *, uint16_t **, uint_t *);
266int nvpair_value_int32_array(nvpair_t *, int32_t **, uint_t *);
267int nvpair_value_uint32_array(nvpair_t *, uint32_t **, uint_t *);
268int nvpair_value_int64_array(nvpair_t *, int64_t **, uint_t *);
269int nvpair_value_uint64_array(nvpair_t *, uint64_t **, uint_t *);
270int nvpair_value_string_array(nvpair_t *, char ***, uint_t *);
271int nvpair_value_nvlist_array(nvpair_t *, nvlist_t ***, uint_t *);
272int nvpair_value_hrtime(nvpair_t *, hrtime_t *);
b128c09f
BB
273#if !defined(_KERNEL)
274int nvpair_value_double(nvpair_t *, double *);
275#endif
34dc7c2f
BB
276
277#ifdef __cplusplus
278}
279#endif
280
281#endif /* _SYS_NVPAIR_H */