nis_error(3NSL) Networking Services Library Functions nis_error(3NSL)NAME
nis_error, nis_sperrno, nis_perror, nis_lerror, nis_sperror, nis_sper‐
ror_r - display NIS+ error messages
SYNOPSIS
cc [ flag ... ] file ... -lnsl [ library ... ]
#include <rpcsvc/nis.h>
char *nis_sperrno(nis_error status);
void nis_perror(nis_error status, char *label);
void nis_lerror(nis_error status, char *label);
char *nis_sperror_r(nis_error status, char *label, char *buf, int
length);
char *nis_sperror(nis_error status, 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 standard 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 call‐
er 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). status and label are the same as for nis_perror(). The
pointer returned by nis_sperror_r() is the same as buf, that is, the
pointer returned by the function is a pointer to buf. length specifies
the number of characters to copy from the error string to buf.
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.
When compiling multithreaded applications, see Intro(3), Notes On Mul‐
tithread Applications, for information about the use of the _REENTRANT
flag.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOniserror(1), string(3C), syslog(3C), attributes(5)NOTES
NIS+ might not be supported in future releases of the Solaris operating
system. Tools to aid the migration from NIS+ to LDAP are available in
the current Solaris release. For more information, visit
http://www.sun.com/directory/nisplus/transition.html.
SunOS 5.10 10 Nov 2005 nis_error(3NSL)