t_strerror(3)                                             t_strerror(3)

  t_strerror()

  NAME

    t_strerror - produce an error message string

  SYNOPSIS

    #include 

    const char *t_strerror(
        int errnum)

  DESCRIPTION

    The t_strerror(3) function has only one parameter.

    Parameters     Before call     After call

    errnum         x               /

    The t_strerror(3) 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 may be overwritten by a subsequent call to
    the t_strerror(3) function. The string is not terminated by a newline
    character. The language for error message strings written by t_strerror(3)
    is that of the current locale. If it is English, the error message string
    describing the value in t_errno may be derived from the comments following
    the t_errno codes defined in . If an error code is unknown, and the
    language is English, t_strerror(3) returns the string:

    ": error unknown"

    where  is the error number supplied as input. In other languages,
    an equivalent text is provided.

  VALID STATES

    ALL - apart from T_UNINIT

  RETURN VALUE

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

  SEE ALSO

    t_error(3)

  USAGE NOTES

    The t_strerror function is not thread safe.

    The t_strerror function is not async-signal safe.