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)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004