Content-type: text/html Man page of t_strerror

t_strerror

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

t_strerror - Produces an error message string  

LIBRARY

XTI Library (libxti.a)  

SYNOPSIS

#include <xti.h>

char *t_strerror (int errnum);  

PARAMETERS

The following table summarizes the relevance of input and output parameters before and after t_strerror() is called:

ParametersBefore CallAfter Call
errnumyn
Table Notes:

y       This is a meaningful parameter.
n       This is not a meaningful parameter.
errnum
Specifies an error number that corresponds to an XTI error.
 

VALID STATES

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

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.  

RELATED INFORMATION

Functions: t_error(3) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
VALID STATES
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:55 GMT, October 02, 2010