Manual Pages for UNIX Operating System command usage for man yp_update

Networking Services Library Functions             yp_update(3NSL)



NAME
     yp_update - change NIS information

SYNOPSIS
     #include 



     int yp_update(char *domain, char *map, unsigned ypop, char *key,
          char *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  POP_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.


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

RETURN VALUES
     If the value of  ypop is   POP_CHANGE,  yp_update()  returns
     the error YPERR_KEY if the key is not found in the database.


     If the value of  ypop is   POP_INSERT,  yp_update()  returns
     the  error  YPERR_KEY if the key already exists in the data-
     base.

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












SunOS 5.11          Last change: 30 Dec 1996                    1






Networking Services Library Functions             yp_update(3NSL)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|


SEE ALSO
     secure_rpc(3NSL), ypclnt(3NSL), attributes(5)

NOTES
     This interface  is  unsafe  in  multithreaded  applications.
     Unsafe  interfaces  should  be  called  only  from  the main
     thread.









































SunOS 5.11          Last change: 30 Dec 1996                    2