HP-UX Reference (11i v2 07/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

653

654

655

656

657

658

659

660

661

662

ypupdate(3C) ypupdate(3C)

NAME

ypupdate - changes NIS information

SYNOPSIS

cc [ ﬂag ... ] ﬁle...

-lnsl [ library. . . ]

#include <rpcsvc/ypclnt.h>

yp_update (domain, map, ypop, key, keylen, data, datalen)

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.

MULTITHREAD USAGE

Thread Safe: Yes

Cancel Safe: Yes

Fork Safe: No

Async-cancel Safe: No

Async-signal Safe: No

These functions can be called safely in a multithreaded environment. They may be cancellation points in

that they call functions that are cancel points.

In a multithreaded environment, these functions are not safe to be called by a child process after fork()

and before exec(). These functions should not be called by a multithreaded application that support

asynchronous cancellation or asynchronous signals.

AUTHOR

The yp_update routine was developed by Sun Microsystems, Inc.