HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

t_strerror(3) t_strerror(3)

NAME

t_strerror() - produce an error message string

SYNOPSIS

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

int *t_strerror (errnum);

int errnum;

struct info *info;

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 modiﬁed by the program, but 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-deﬁned. If it is English, the error message string describ-

ing 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.

Thread-Safeness

The

t_strerror() function is safe to be called by multithreaded applications, and it is thread-safe for

both POSIX Threads and DCE User Threads. It has a cancellation point. It is neither async-cancel safe

nor async-signal safe. Finally, it is not fork-safe.

Valid Status

All - apart from

T_UNINIT.

RETURN VALUE

The function

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