Makes changes to an Network Information Service (NIS) map.
C Library (libc.a)
#include <rpcsvc/ypclnt.h> #include <rpcsvc/yp_prot.h>
yp_update (indomain, inmap, ypop, inkey, inkeylen, indata, indatalen) char *indomain; char *inmap; unsigned ypop; char *inkey; int inkeylen; char *indata; int indatalen;
Note: This routine depends upon the secure Remote Procedure Call (RPC) protocol, and will not work unless the network is running it.
The yp_update subroutine is used to make changes to a NIS map. The syntax is the same as that of the yp_match subroutine except for the additional ypop parameter, which may take on one of the following four values:
|ypop _INSERT||Inserts the key-value pair into the map. If the key already exists in the map, the yp_update subroutine returns a value of YPERR_KEY.|
|ypop_CHANGE||Changes the data associated with the key to the new value. If the key is not found in the map, the yp_update subroutine returns a value of YPERR_KEY.|
|ypop_STORE||Stores an item in the map regardless of whether the item already exists. No error is returned in either case.|
|ypop_DELETE||Deletes an entry from the map.|
|indomain||Points to the name of the domain used as input to the subroutine.|
|inmap||Points to the name of the map used as input to the subroutine.|
|ypop||Specifies the update operation to be used as input to the subroutine.|
|inkey||Points to the input key to be used as input to the subroutine.|
|inkeylen||Specifies the length, in bytes, of the inkey parameter.|
|indata||Points to the data used as input to the subroutine.|
|indatalen||Specifies the length, in bytes, of the data used as input to the subroutine.|
Upon successful completion, this routine returns a value of 0. If unsuccessful, it returns one of the error codes described in the rpcsvc/yp_prot.h file.
This subroutine is part of Base Operating System (BOS) Runtime.
|/var/yp/updaters||A makefile for updating NIS maps.|
The yp_match subroutine.
Network Information Service (NIS) Overview for System Management in AIX Version 4.3 System Management Guide: Communications and Networks.
List of NIS Programming References and Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.