[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1
yp_update Subroutine
Purpose
Makes changes to an Network Information Service (NIS) map.
Library
C Library (libc.a)
Syntax
#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;
Description
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. |
Parameters
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. |
Return Values
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.
Implementation Specifics
This subroutine is part of Base Operating System (BOS) Runtime.
Files
Related Information
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.
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]