t_strerror(3N)							t_strerror(3N)

NAME    [Toc]    [Back]

     t_strerror	- produce an error message string

SYNOPSIS    [Toc]    [Back]

     #ifdef _XOPEN_SOURCE
     #include <xti.h>

     char *t_strerror(int errnum)
     #endif

DESCRIPTION    [Toc]    [Back]

     t_strerror	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 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,
     t_strerror() returns the string:

	  <error>: error unknown

     where <error> is the error	number supplied	as input and is	represented as
     %d	within the message text.  The implementation uses the format of	%2d to
     produce a maximum of two ASCII decimal digits within the message text
     returned.	So, an error number greater than decimal 99 will produce a
     decimal value of 99.

EXAMPLE    [Toc]    [Back]

     For a t_errno equal to 5, the following corresponding message pointer is
     returned:

	  char *msgptr;
	  msgptr = t_strerror((int)5);

     The returned diagnostic message pointer would point to the	text:

	  couldn't allocate address

     This function resides within the X/Open compliant libxnet Network
     Services library.	Network	Services applications which require X/Open
     compliance	must link-load with -lxnet.

DIAGNOSTICS    [Toc]    [Back]

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

FILES    [Toc]    [Back]

     /usr/lib/locale/locale<b>/LC_MESSAGES/uxlibxnet
	  language-specific message file [See LANG on environ(5).]




									Page 1






t_strerror(3N)							t_strerror(3N)

SEE ALSO    [Toc]    [Back]

     t_error(3N)


									PPPPaaaaggggeeee 2222