t_strerror(3xti)

t_strerror -- get error message string

Synopsis

cc [options] file -lnsl

#include <xti.h>

char t_strerror(int errnum);

Description

The t_strerror function is a TLI/XTI local management routine that returns, for the error number specified by errnum, the pointer to a language dependent error message string.

When t_strerror is issued, the contents of the string pointed to on return are not modified, but may be modified by a subsequent call to t_strerror.

The comments used in the header file xti.h to describe the values in t_errno are identical to the error message string pointed to by t_strerror on return. If the language is not English, the text provided is equivalent.

The error message string itself is not ended by a newlne character.

If the value supplied in errnum is not recognized, the response from t_strerror is a pointer to the following string:

   <errnum>: error unknown

where <errnum> is the value supplied on the call.

Parameters

errnum: the TLI/XTI number for the language-dependent error message string.

Files

/usr/lib/libxti.so: X/Open^® Transport Interface Library (shared object)
/usr/lib/libnsl.so: Network Services Library (shared object)
/usr/lib/locale/locale/LC_MESSAGES/uxsnl

Return values

t_strerror returns a string pointer to the requested error. No errors are defined.

State transitions

t_strerror may be issued from any valid state except T_UNINIT and has no effect on the state.

References

intro(2), t_error(3xti)