Networking Services Library Functions t_strerror(3NSL)
NAME
t_strerror - produce an error message string
SYNOPSIS
#include
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 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 thet_strerror function. The string is not terminated by a new-
line character. The language for error message strings writ-
ten by t_strerror() is that of the current locale. If it is
English, the error message string describing the value int_errno may be derived from the comments following the
t_errno codes defined in
. If an error code is unknown, and the language is English, t_strerror() returns
the string: ": error unknown" where is the error number supplied as input. In other languages, 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 COMPATIBILITYSunOS 5.11 Last change: 7 May 1998 1
Networking Services Library Functions t_strerror(3NSL)
The XTI and TLI interface definitions have common names butuse different header files. This, and other semantic differ-
ences between the two interfaces are described in the sub-
sections below. Interface HeaderThe XTI interfaces use the header file, xti.h. TLI inter-
faces should not use this header. They should use the header:#include
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| MT Level | Safe ||_____________________________|_____________________________|
SEE ALSO
t_errno(3NSL),t_error(3NSL), attributes(5)
SunOS 5.11 Last change: 7 May 1998 2