nis_error(3N)

NAME

nis_error, nis_sperrno, nis_perror, nis_lerror, nis_sperror, nis_sperror_r − display NIS+ error messages

SYNOPSIS

cc [ flag... ] file... −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);

MT-LEVEL

Safe

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 standard error.

nis_lerror() sends the error text to syslog(3) 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 sufficiently 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 multi-threaded programs.

NOTES

When compiling multithreaded applications, see Intro(3), Notes On Multithread Applications, for information about the use of the _REENTRANT flag.

SunOS 5.5/SPARC — Last change: 15 Jul 1993

Museum