t_strerror.3 (2010 09)

t_strerror(3) t_strerror(3)

NAME

t_strerror() - produce an error message string

SYNOPSIS

#include <xti.h> /* for X/OPEN Transport Interface - XTI */

char *t_strerror (errnum);

int errnum;

DESCRIPTION

The t_strerror() function maps the error number in errnum that corresponds to an XTI (X/OPEN

Transport Interface) error to a language-dependent error message string and returns a pointer to the

string. The string pointed to may not be modiﬁed by the program, but may be overwritten by a subse-

quent 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-deﬁned. If it is

English, the error message string describing the value in

t_errno is identical to the comments following

the

t_errno deﬁned in <xti.h>

. If an error code is unknown, and the language is English,

t_strerror() returns the string:

error

: error unknown

where error is the error number supplied as input. In other languages, an equivalent text is provided.

Valid Status

All - apart from

T_UNINIT.

Fork Safety

t_strerror is not fork-safe.

RETURN VALUE

The function

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