t_strerror(3N)
NAME
t_strerror − get error message string
SYNOPSIS
cc [ flag ... ] file ... −lnsl [ library ... ]
#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, a different header file, tiuser.h , must be used. Refer to the section, TLI COMPATIBILITY , for a description of differences between the two interfaces.
The t_strerror() function maps the supplied number (errnum) corresponding to a transport-level error to a language-specific error message string and returns a pointer to that 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 the 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 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 languages, an equivalent text is provided.
VALID STATES
Legitimate states (see t_getstate(3N)) for a call to this routine are every one except 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 different 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>
For more information refer to the Transport Interfaces Programming Guide.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| MT-Level | Unsafe |
SEE ALSO
gettext(3C), perror(3C), setlocale(3C), strerror(3C), t_error(3N), attributes(5)
Transport Interfaces Programming Guide
SunOS 5.6 — Last change: 10 Feb 1997