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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

671

672

673

674

675

676

677

678

679

680

ypclnt(3C) ypclnt(3C)

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.

WARNINGS

The NIS Version 1 protocol will not be available in a future HP-UX release. HP recommends that you use

the next version of this protocol.

RETURN VALUE

All functions in this package of type int return 0 if the requested operation is successful or one of the fol-

lowing 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.