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)