ypupdate(3C)

NAME

ypupdate − changes NIS information

SYNOPSIS

#include <rpcsvc/ypclnt.h>

yp_update (domain, map, ypop, key, keylen,

char *domain;

char *map;

unsigned ypop;

char *key;

int keylen;

char *data;

int datalen;

Remarks

The Network Information Service (NIS) was formerly known as Yellow Pages (yp). Although the name has changed, the functionality of the service remains the same.

DESCRIPTION

The routine yp_update() is used to make changes to the Network Information Service (NIS) database. The syntax is the same as that of yp_match() (see ypclnt(3C)) except for the extra parameter ypop which may take on one of four values.

YPOP_CHANGE 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() returns YPERR_KEY.

YPOP_INSERT The key-value pair will be inserted into the database. The error YPERR_KEY is returned if the key already exists in the database.

YPOP_STORE The key-value pair will be stored into the database without concern for whether it already exists or not.

YPOP_DELETE The key-value pair will be deleted from the database.

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

AUTHOR

The yp_update routine was developed by Sun Microsystems, Inc.

Museum