t_strerror(3NSL) Networking Services Library Functions t_strerror(3NSL)NAMEt_strerror - produce an error message string
SYNOPSIS
#include <xti.h>
const char *t_strerror(int errnum);
DESCRIPTION
This routine is part of the XTI interfaces which evolved from the TLI
interfaces. XTI represents the future evolution of these interfaces.
However, TLI interfaces are supported for compatibility. When using a
TLI routine that has the same name as an XTI routine, the tiuser.h
header file must be used. Refer to the TLI COMPATIBILITY section for
a description of differences between the two interfaces.
The t_strerror() function maps the error number in errnum that corre‐
sponds 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 mod‐
ified 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_str‐
error() is that of the current locale. If it is English, the error mes‐
sage string describing the value in t_errno may be derived from 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
string:
"<error>: error unknown"
where <error> is the error number supplied as input. In other lan‐
guages, an equivalent text is provided.
VALID STATES
ALL - apart from T_UNINIT.
RETURN VALUES
The function t_strerror() returns a pointer to the generated message
string.
TLI COMPATIBILITY
The XTI and TLI interface definitions have common names but use differ‐
ent header files. This, and other semantic differences between the two
interfaces are described in the subsections below.
Interface Header
The XTI interfaces use the header file, xti.h. TLI interfaces should
not use this header. They should use the header:
#include <tiuser.h>
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOt_errno(3NSL),t_error(3NSL), attributes(5)SunOS 5.10 7 May 1998 t_strerror(3NSL)