t_strerror(3N)

NAME
     t_strerror - produce an error message string

SYNOPSIS
     #ifdef _XOPEN_SOURCE
     #include <xti.h>

     char *t_strerror(int errnum)
     #endif

DESCRIPTION
     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
     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
     t_strerror() returns a pointer to the generated message string.

FILES
     /usr/lib/locale/locale/LC_MESSAGES/uxlibxnet
          language-specific message file [See LANG on environ(5).]
SEE ALSO
     t_error(3N)