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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

591

592

593

594

595

596

597

598

599

600

ypclnt(3C) ypclnt(3C)

yp_master() Returns the host name of the master NIS server for a map.

yperr_string()

Returns a pointer to an error message string that is null-terminated, but contains

no period or newline.

ypprot_err() Takes an NIS protocol error code as input and returns a ypclnt layer error code that

can be used as input to

yperr_string()

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.

RETURN VALUE

All functions in this package of type

int return 0 if the requested operation is successful or one of the

following errors if the operation fails.

[YPERR_ACCESS] database access violation

[YPERR_BADARGS] args to function are bad

[YPERR_BADDB] NIS map is defective

[YPERR_BUSY] database busy

[YPERR_DOMAIN] cannot bind to server on this NIS domain

[YPERR_KEY] no such key in map

[YPERR_MAP] no such map in server’s NIS domain

[YPERR_NODOM] local NIS domain name not set

[YPERR_NOMORE] no more records in map

[YPERR_PMAP] cannot communicate with portmap

[YPERR_RESRC] resource allocation failure

[YPERR_RPC] RPC failure − NIS domain has been unbound

[YPERR_VERS] NIS client/server version mismatch: the NIS server bound to uses Version 1

protocol, so it does not provide

yp_all() functionality

[YPERR_YPBIND] cannot communicate with ypbind

[YPERR_YPERR] internal NIS server or client error

[YPERR_YPSERV] cannot communicate with ypserv

AUTHOR

ypclnt() was developed by Sun Microsystems, Inc.