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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

nis_error(3N) nis_error(3N)

NAME

nis_error(), nis_sperrno(), nis_perror(), nis_lerror(), nis_sperror(), nis_sperror_r() - display NIS+ error mes-

sages

SYNOPSIS

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

-lnsl [ library. . . ]

#include <rpcsvc/nis.h>

char *nis_sperrno(const nis_error

status);

void nis_perror(const nis_error

status,

const char *

label);

void nis_lerror(const nis_error

status,

const char *

label);

char *nis_sperror_r(nis_error

status,

char *

label,

char *

buf);

char *nis_sperror(const nis_error

status,

const char *

label);

DESCRIPTION

These functions convert NIS+ status values into text strings.

nis_sperrno() simply returns a pointer to a string constant which is the error string.

nis_perror( ) prints the error message corresponding to status as ‘‘label:

error message’’ on stan-

dard error.

nis_lerror() sends the error text to syslog(3C) at level LOG_ERR.

The function nis_sperror_r()

, returns a pointer to a string that can be used or copied using the

strdup() function (see string(3C).) The caller must supply a string buffer, buf, large enough to hold the

error string (a buffer size of 128 bytes is guaranteed to be sufﬁciently large).

The last function,

nis_sperror()

, is similar to nis_sperror_r() except that the string is returned

as a pointer to a buffer that is reused on each call.

nis_sperror_r()

is the preferred interface, since it

is suitable for single-threaded and multithreaded programs.

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. These functions may be thread can-

cellation points because they invoke functions that are thread cancellation 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

HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is supported.

LDAP is the recommended replacement for NIS+. HP fully supports the industry standard naming ser-

vices based on LDAP.