1nvlist_next_nvpair(9F)   Kernel Functions for Drivers   nvlist_next_nvpair(9F)
2
3
4

NAME

6       nvlist_next_nvpair,  nvpair_name,  nvpair_type  - return data regarding
7       name-value pairs
8

SYNOPSIS

10       #include <sys/nvpair.h>
11
12       nvpair_t *nvlist_next_nvpair(nvlist_t *nvl, nvpair_t *nvpair);
13
14
15       char *nvpair_name(nvpair_t *nvpair);
16
17
18       data_type_t nvpair_type(nvpair_t *nvpair);
19
20

INTERFACE LEVEL

22       Solaris DDI specific (Solaris DDI)
23

PARAMETERS

25       nvl       The list of name-value pairs (nvlist_t) to be processed.
26
27
28       nvpair    Handle to a name-value pair.
29
30

DESCRIPTION

32       The nvlist_next_nvpair() function returns a handle to  the  next  name-
33       value  pair  (nvpair)  in the list following nvpair. If nvpair is NULL,
34       the first pair is returned. If nvpair is the last pair in the nvlist_t,
35       NULL is returned.
36
37
38       The  nvpair_name()  function  returns  a  string containing the name of
39       nvpair.
40
41
42       The nvpair_type() function retrieves the value of  the  nvpair  in  the
43       form  of  enumerated  type  data_type_t.  This is used to determine the
44       appropriate nvpair_*() function to call for retrieving the value.
45

RETURN VALUES

47       For nvpair_name(): a string containing the name.
48
49
50       For nvpair_type(): an enumerated data type data_type_t. Possible values
51       for data_type_t are:
52
53         DATA_TYPE_BOOLEAN
54         DATA_TYPE_BOOLEAN_VALUE
55         DATA_TYPE_BYTE
56         DATA_TYPE_INT8
57         DATA_TYPE_UINT8
58         DATA_TYPE_INT16
59         DATA_TYPE_UINT16
60         DATA_TYPE_INT32
61         DATA_TYPE_UINT32
62         DATA_TYPE_INT64
63         DATA_TYPE_UINT64
64         DATA_TYPE_STRING
65         DATA_TYPE_NVLIST
66         DATA_TYPE_BOOLEAN_ARRAY
67         DATA_TYPE_BYTE_ARRAY
68         DATA_TYPE_INT8_ARRAY
69         DATA_TYPE_UINT8_ARRAY
70         DATA_TYPE_INT16_ARRAY
71         DATA_TYPE_UINT16_ARRAY
72         DATA_TYPE_INT32_ARRAY
73         DATA_TYPE_UINT32_ARRAY
74         DATA_TYPE_INT64_ARRAY
75         DATA_TYPE_UINT64_ARRAY
76         DATA_TYPE_STRING_ARRAY
77         DATA_TYPE_NVLIST_ARRAY
78
79
80
81
82       After  nvpairs  is  removed from or replaced in an nvlist, it cannot be
83       manipulated.  This  includes  nvlist_next_nvpair(),  nvpair_name()  and
84       nvpair_type().  Replacement  can happen during pair addition on nvlists
85       created    with    NV_UNIQUE_NAME_TYPE    and    NV_UNIQUE_NAME.    See
86       nvlist_alloc(9F) for more details.
87

CONTEXT

89       These functions can be called from user, interrupt, or kernel context.
90
91
92
93SunOS 5.11                        16 Jan 2006           nvlist_next_nvpair(9F)
Impressum