Index for Section 3

Alphabetical listing for T

t_strerror(3)
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:

		     Parameters	  Before Call	After Call
		     errnum	       y	    n
  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)