[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Communications Technical Reference, Volume 1

yp_update Subroutine

Purpose

Makes changes to an Network Information Services (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

/var/yp/updaters A makefile for updating NIS maps.

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.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]