opensolaris man page for nvlist_remove

nvlist_remove(9F)					   Kernel Functions for Drivers 					 nvlist_remove(9F)

NAME
       nvlist_remove, nvlist_remove_all - remove name-value pairs

SYNOPSIS
       #include <sys/nvpair.h>

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

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

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI)

PARAMETERS
       nvl     The list of name-value pairs (nvlist_t) to be processed.

       name    Name of the name-value pair (nvpair) 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 may 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.

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

ERRORS
       EINVAL	 There is an invalid argument.

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

SunOS 5.11							    16 Jan 2006 						 nvlist_remove(9F)