nvpair_impl.h revision 292973
1/*-
2 * Copyright (c) 2009-2013 The FreeBSD Foundation
3 * All rights reserved.
4 *
5 * This software was developed by Pawel Jakub Dawidek under sponsorship from
6 * the FreeBSD Foundation.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 *    notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 *    notice, this list of conditions and the following disclaimer in the
15 *    documentation and/or other materials provided with the distribution.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * SUCH DAMAGE.
28 *
29 * $FreeBSD: stable/10/sys/sys/nvpair_impl.h 292973 2015-12-31 03:28:14Z ngie $
30 */
31
32#ifndef	_NVPAIR_IMPL_H_
33#define	_NVPAIR_IMPL_H_
34
35#include <sys/queue.h>
36
37#ifndef _KERNEL
38#include <stdint.h>
39#endif
40
41#include "nv.h"
42
43TAILQ_HEAD(nvl_head, nvpair);
44
45void nvpair_assert(const nvpair_t *nvp);
46nvlist_t *nvpair_nvlist(const nvpair_t *nvp);
47nvpair_t *nvpair_next(const nvpair_t *nvp);
48nvpair_t *nvpair_prev(const nvpair_t *nvp);
49void nvpair_insert(struct nvl_head *head, nvpair_t *nvp, nvlist_t *nvl);
50void nvpair_remove(struct nvl_head *head, nvpair_t *nvp, const nvlist_t *nvl);
51size_t nvpair_header_size(void);
52size_t nvpair_size(const nvpair_t *nvp);
53const unsigned char *nvpair_unpack(bool isbe, const unsigned char *ptr,
54    size_t *leftp, nvpair_t **nvpp);
55void nvpair_free_structure(nvpair_t *nvp);
56void nvpair_init_datasize(nvpair_t *nvp);
57const char *nvpair_type_string(int type);
58
59/* Pack functions. */
60unsigned char *nvpair_pack_header(const nvpair_t *nvp, unsigned char *ptr,
61    size_t *leftp);
62unsigned char *nvpair_pack_null(const nvpair_t *nvp, unsigned char *ptr,
63    size_t *leftp);
64unsigned char *nvpair_pack_bool(const nvpair_t *nvp, unsigned char *ptr,
65    size_t *leftp);
66unsigned char *nvpair_pack_number(const nvpair_t *nvp, unsigned char *ptr,
67    size_t *leftp);
68unsigned char *nvpair_pack_string(const nvpair_t *nvp, unsigned char *ptr,
69    size_t *leftp);
70unsigned char *nvpair_pack_descriptor(const nvpair_t *nvp, unsigned char *ptr,
71    int64_t *fdidxp, size_t *leftp);
72unsigned char *nvpair_pack_binary(const nvpair_t *nvp, unsigned char *ptr,
73    size_t *leftp);
74unsigned char *nvpair_pack_nvlist_up(unsigned char *ptr, size_t *leftp);
75
76/* Unpack data functions. */
77const unsigned char *nvpair_unpack_header(bool isbe, nvpair_t *nvp,
78    const unsigned char *ptr, size_t *leftp);
79const unsigned char *nvpair_unpack_null(bool isbe, nvpair_t *nvp,
80    const unsigned char *ptr, size_t *leftp);
81const unsigned char *nvpair_unpack_bool(bool isbe, nvpair_t *nvp,
82    const unsigned char *ptr, size_t *leftp);
83const unsigned char *nvpair_unpack_number(bool isbe, nvpair_t *nvp,
84    const unsigned char *ptr, size_t *leftp);
85const unsigned char *nvpair_unpack_string(bool isbe, nvpair_t *nvp,
86    const unsigned char *ptr, size_t *leftp);
87const unsigned char *nvpair_unpack_nvlist(bool isbe, nvpair_t *nvp,
88    const unsigned char *ptr, size_t *leftp, size_t nvlist, nvlist_t **child);
89const unsigned char *nvpair_unpack_descriptor(bool isbe, nvpair_t *nvp,
90    const unsigned char *ptr, size_t *leftp, const int *fds, size_t nfds);
91const unsigned char *nvpair_unpack_binary(bool isbe, nvpair_t *nvp,
92    const unsigned char *ptr, size_t *leftp);
93
94#endif	/* !_NVPAIR_IMPL_H_ */
95