nvlist_remove(3NVPAIR)					 Name-value Pair Library Functions				    nvlist_remove(3NVPAIR)

NAME

       nvlist_remove, nvlist_remove_all - remove name-value pairs

SYNOPSIS

       cc [ flag... ] file... -lnvpair [ library... ]
       #include <libnvpair.h>

       int nvlist_remove(nvlist_t *nvl, const char *name, data_type_t type);

       int nvlist_remove_all(nvlist_t *nvl, const char *name);

PARAMETERS

       nvl	The nvlist_t to be processed.

       name	Name of the name-value pair to be removed.

       type	Data type of the nvpair to be removed.

DESCRIPTION

       The nvlist_remove() function removes the first occurrence of nvpair that matches the name and the type.

       The nvlist_remove_all() function removes all occurrences of nvpair that match the name, regardless of type.

       Multiple  threads  can simultaneously read the same nvlist_t but only one thread can actively change a given nvlist_t at a time. The caller
       is responsible for the synchronization.

RETURN VALUES

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

ERRORS

       These functions will fail if:

       EINVAL	       There is an invalid argument.

       ENOENT	       No name-value pairs were found to match the criteria specified by name and type.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +----------------------------+------------------------------+
       |      ATTRIBUTE TYPE	    |	    ATTRIBUTE VALUE	   |
       +----------------------------+------------------------------+
       |Interface Stability	    | Evolving			   |
       +----------------------------+------------------------------+
       |MT-Level		    | MT-Safe			   |
       +----------------------------+------------------------------+

SEE ALSO

       libnvpair(3LIB), attributes(5)

SunOS 5.10							    2 Feb 2004						    nvlist_remove(3NVPAIR)