|Skip Navigation Links|
|Exit Print View|
|man pages section 3: Extended Library Functions, Volume 3 Oracle Solaris 11.1 Information Library|
- remove name-value pairs
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);
The nvlist_t to be processed.
Name of the name-value pair to be removed.
Data type of the nvpair to be removed.
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.
These functions return 0 on success and an error value on failure.
These functions will fail if:
There is an invalid argument.
No name-value pairs were found to match the criteria specified by name and type.
See attributes(5) for descriptions of the following attributes: