t_strerror(3)						     Library Functions Manual						     t_strerror(3)

NAME

       t_strerror - Produces an error message string

LIBRARY

       XTI Library (libxti.a)

SYNOPSIS

       #include <xti.h>

       char *t_strerror (int errnum);

STANDARDS

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

       t_strerror():  XNS4.0

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

PARAMETERS

       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
       Table Notes:
       y       This is a meaningful parameter.
       n       This is not a meaningful parameter.

       errnum	 Specifies an error number that corresponds to an XTI error.

VALID STATES

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

DESCRIPTION

       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

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

RELATED INFORMATION

       Functions: t_error(3) delim off

																     t_strerror(3)