Networking Services Library Functions             niserror(3NSL)



NAME
     niserror, nissperrno, nisperror, nislerror, nissperror,
     nissperrorr - display NIS] error messages

SYNOPSIS
     cc [ flag ... ] file ... -lnsl [ library ... ]
     #include 



     char *nissperrno(niserror status);


     void nisperror(niserror status, char *label);


     void nislerror(niserror status, char *label);


     char *nissperrorr(niserror status, char *label, char *buf, int length);


     char *nissperror(niserror status, char *label);


DESCRIPTION
     These  functions  convert  NIS]  status  values  into   text
     strings.


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


     nisperror()  prints  the  error  message  corresponding  to
     status as ``label: error message'' on standard error.


     nislerror() sends the error text  to  syslog(3C)  at  level
     LOGER.


     The function nissperrorr(), 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).  status  and
     label are the same as for nisperror(). The pointer returned
     by  nissperrorr() is the same as buf, that is, the pointer
     returned  by the function is a pointer to buf. length speci-
     fies the number of characters to copy from the error  string
     to buf.



SunOS 5.11          Last change: 10 Nov 2005                    1






Networking Services Library Functions             niserror(3NSL)



     The   last   function,   nissperror(),   is   similar    to
     nissperrorr()  except  that  the  string  is returned as a
     pointer  to  a  buffer  that  is  reused   on   each   call.
     nissperrorr()  is  the  preferred  interface,  since it is
     suitable for single-threaded and multi-threaded programs.


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

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    


SEE ALSO
     niserror(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.11          Last change: 10 Nov 2005                    2