Index Index for
Section 3
Index Alphabetical
listing for T
Bottom of page Bottom of
page

t_strerror(3)

NAME

t_strerror - Produce an error message string

SYNOPSIS

#include <xti.h> char *t_strerror( int errnum );

LIBRARY

XTI Library (libxti.a)

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows: t_strerror(): XNS4.0, XNS5.0 Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

The following table summarizes the relevance of input and output parameters before and after t_strerror() is called: _____________________________________ Parameters Before Call After Call _____________________________________ errnum y n _____________________________________ Notes to Table: y This is a meaningful parameter. n This is not a meaningful parameter. errnum Specifies an error number that corresponds to an XTI error.

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 it 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 codes defined in <xti.h>. If an error code is unknown and the language is English, t_strerror() returns the following string, where error is the error number supplied as input: "error: error unknown" In other languages, an equivalent text is provided.

RETURN VALUES

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

VALID STATES

The t_strerror() function can be called in all the transport provider states, except T_UNINIT.

SEE ALSO

Functions: t_error(3) Standards: standards(5) Network Programmer's Guide

Index Index for
Section 3
Index Alphabetical
listing for T
Top of page Top of
page