Manual Pages for UNIX Operating System command usage for man nvlist_remove

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 

     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  cri-
               teria specified by name and type.






SunOS 5.11           Last change: 2 Feb 2004                    1






Name-value Pair Library Functions          nvlist_remove(3NVPAIR)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE       |        ATTRIBUTE VALUE       |
    |____________________________|______________________________|
    | Interface Stability        |  Committed                   |
    |____________________________|______________________________|
    | MT-Level                   |  MT-Safe                     |
    |____________________________|______________________________|


SEE ALSO
     libnvpair(3LIB), attributes(5)






































SunOS 5.11           Last change: 2 Feb 2004                    2