Name-value Pair Library Functions          nvlistremove(3NVPAIR)



NAME
     nvlistremove, nvlistremoveall - remove name-value pairs

SYNOPSIS
     cc [ flag... ] file... -lnvpair [ library... ]
     #include 

     int nvlistremove(nvlistt *nvl, const char *name,
          datatypet type);


     int nvlistremoveall(nvlistt *nvl, const char *name);


PARAMETERS
     nvl     The nvlistt to be processed.


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


     type    Data type of the nvpair to be removed.


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


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


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

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

ERORS
     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          nvlistremove(3NVPAIR)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


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






































SunOS 5.11           Last change: 2 Feb 2004                    2