NAME

t_strerror − Produce an error message string

SYNOPSIS

#include <xti.h>
char ∗t_strerror(
        int errnum );

LIBRARY

XTI Library (libxti.a)

STANDARDS

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

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

Notes to Table:

yThis is a meaningful parameter. 

nThis is not a meaningful parameter. 

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

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. 

VALID STATES

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

SEE ALSO

Functions: t_error(3)

Standards: standards(5)

Network Programmer’s Guide