Networking Services Library Functions            tstrerror(3NSL)



NAME
     tstrerror - produce an error message string

SYNOPSIS
     #include 




     const char *tstrerror(int errnum);


DESCRIPTION
     This routine is part of the  XTI  interfaces  which  evolved
     from the TLI interfaces. XTI represents the future evolution
     of these interfaces. However, TLI interfaces  are  supported
     for  compatibility.  When  using  a TLI routine that has the
     same name as an XTI routine, the  tiuser.h header file  must
     be  used.   Refer  to  the   TLI COMPATIBILITY section for a
     description of differences between the two interfaces.


     The tstrerror() function maps the error  number  in  errnum
     that  corresponds  to  an  XTI error to a language-dependent
     error message string and returns a pointer  to  the  string.
     The  string  pointed to will not be modified by the program,
     but  may  be  overwritten  by  a  subsequent  call  to   the
     tstrerror  function. The string is not terminated by a new-
     line character. The language for error message strings writ-
     ten  by tstrerror() is that of the current locale. If it is
     English, the error message string describing  the  value  in
     terrno  may  be  derived  from  the  comments following the
     terrno codes defined  in  .  If  an  error  code  is
     unknown,  and  the language is English, tstrerror() returns
     the string:

       ": error unknown"



     where  is the error number  supplied  as  input.   In
     other languages, an equivalent text is provided.

VALID STATES
     AL - apart from TUNINIT.

RETURN VALUES
     The function tstrerror() returns a pointer to the generated
     message string.

TLI COMPATIBILITY




SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions            tstrerror(3NSL)



     The XTI and TLI interface definitions have common names  but
     use different header files. This, and other semantic differ-
     ences between the two interfaces are described in  the  sub-
     sections below.

  Interface Header
     The XTI interfaces use the header file,  xti.h.  TLI  inter-
     faces  should  not  use  this  header.   They should use the
     header:
       #include 

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT Level                     Safe                        
    


SEE ALSO
     terrno(3NSL),terror(3NSL), attributes(5)





























SunOS 5.11           Last change: 7 May 1998                    2