ypupdate(3N)                                                   ypupdate(3N)


   NAME
         yp_update - changes yp information

   SYNOPSIS
         #include <rpcsvc/ypclnt.h>

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

   DESCRIPTION
         yp_update() is used to make changes to the YP database.  The syntax
         is the same as that of yp_match() except for the extra parameter op
         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 op 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
         op as YPOP_STORE and no error will be returned if the key already or
         does not exist.  To delete an entry, the value of op should be
         YPOP_DELETE.

         This routine depends upon secure RPC, and will not work unless the
         network is running secure RPC.

   SEE ALSO
         secure_rpc(3N)



















   7/91                                                                 Page 1