NAME

t_strerror − Produces an error message string

LIBRARY

XTI Library (libxti.a)

SYNOPSIS

#include <xti.h>

char ∗t_strerror (int errnum);

PARAMETERS

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

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)