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

NAME

6       nvlist_remove, nvlist_remove_all - remove name-value pairs
7

SYNOPSIS

9       #include <sys/nvpair.h>
10
11       int nvlist_remove(nvlist_t *nvl, const char *name, data_type_t type);
12
13
14       int  nvlist_remove_all(nvlist_t *nvl, const char *name);
15
16

INTERFACE LEVEL

18       Solaris DDI specific (Solaris DDI)
19

PARAMETERS

21       nvl     The list of name-value pairs (nvlist_t) to be processed.
22
23
24       name    Name of the name-value pair (nvpair) to be removed.
25
26
27       type    Data type of the nvpair to be removed.
28
29

DESCRIPTION

31       The  nvlist_remove()  function  removes  the first occurrence of nvpair
32       that matches the name and the type.
33
34
35       The nvlist_remove_all() function removes all occurrences of nvpair that
36       match the name, regardless of type.
37
38
39       Multiple threads can simultaneously read the same nvlist_t but only one
40       thread may actively change a given nvlist_t at a time.  The  caller  is
41       responsible for the synchronization.
42

RETURN VALUES

44       These functions return 0 on success and an error value on failure.
45

CONTEXT

47       The  nvlist_remove()  and  nvlist_remove_all()  functions can be called
48       from user, interrupt, or kernel context.
49

ERRORS

51       EINVAL    There is an invalid argument.
52
53
54       ENOENT    No name-value pairs were found to match the  criteria  speci‐
55                 fied by name and type.
56
57
58
59
60SunOS 5.11                        16 Jan 2006                nvlist_remove(9F)