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 modified 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-defined.
If it is English, the error message string describing the value in
t_errno
is identical to the comments following the
t_errno
defined in
<xti.h>.
If an error code is unknown, and the language is English,
t_strerror()
returns the string:
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.