yp_update(3Y)

NAME
     yp_update - changes NIS information

SYNOPSIS
     #include <rpcsvc/ypclnt.h>

     yp_update(char *domain, char *map, unsigned ypop, char *key, int keylen,
               char *data, int datalen);

DESCRIPTION
     yp_update() is used to make changes to the NIS database. The syntax is
     the same as that of yp_match() except for the extra parameter ypop which
     may take on one of four values. If it is YPOP_CHANGE, then the data
     associated with the key will be changed to the new value. If the key is
     not found in the database, then yp_update() will return YPERR_KEY.  If
     ypop has the value YPOP_INSERT, then the key-value pair will be inserted
     into the database.  The error YPERR_KEY is returned if the key already
     exists in the database.  To store an item into the database without
     concern for whether it exists already or not, pass ypop as YPOP_STORE and
     no error will be returned if the key already or does not exist.  To
     delete an entry, the value of ypop should be YPOP_DELETE.

SEE ALSO
     ypupdated(1M), updaters(1M)