NAME    [Toc]    [Back]

       t_strerror - Produce an error message string

SYNOPSIS    [Toc]    [Back]

       #include <xti.h>

       char *t_strerror(
               int errnum );

LIBRARY    [Toc]    [Back]

       XTI Library (libxti.a)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       t_strerror():  XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       The  following table summarizes the relevance of input and
       output parameters before and after t_strerror() is called:

       --------------------------------------
       Parameters   Before Call   After Call
       --------------------------------------
       errnum       y             n
       --------------------------------------

       Notes  to  Table: This is a meaningful parameter.  This is
       not a meaningful parameter.   Specifies  an  error  number
       that corresponds to an XTI error.

DESCRIPTION    [Toc]    [Back]

       The  t_strerror() 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  it  may  be  overwritten  by a subsequent call to the
       t_strerror() function. The string is not terminated  by  a
       newline character.

       The  language  for error message strings written by t_strerror()
 is implementation-defined. If it is  English,  the
       error  message  string  describing the value in t_errno is
       identical to the  comments  following  the  t_errno  codes
       defined  in  <xti.h>.  If an error code is unknown and the
       language is English, t_strerror()  returns  the  following
       string, where error is the error number supplied as input:
       "error: error unknown"

       In other languages, an equivalent text is provided.

RETURN VALUES    [Toc]    [Back]

       The function t_strerror() returns a pointer to the  generated
 message string.

VALID STATES    [Toc]    [Back]

       The  t_strerror() function can be called in all the transport
 provider states, except T_UNINIT.

SEE ALSO    [Toc]    [Back]

       Functions: t_error(3)

       Standards: standards(5)

       Network Programmer's Guide



                                                    t_strerror(3)