t_strerror(3nsl)

1t_strerror(3NSL)     Networking Services Library Functions    t_strerror(3NSL)
2
3
4

NAME

6       t_strerror - produce an error message string
7

SYNOPSIS

9       #include <xti.h>
10
11
12
13
14       const char *t_strerror(int errnum);
15
16

DESCRIPTION

18       This  routine  is part of the XTI interfaces which evolved from the TLI
19       interfaces. XTI represents the future evolution  of  these  interfaces.
20       However,  TLI  interfaces are supported for compatibility. When using a
21       TLI routine that has the same name as an  XTI  routine,  the   tiuser.h
22       header  file must be used.  Refer to the  TLI COMPATIBILITY section for
23       a description of differences between the two interfaces.
24
25
26       The t_strerror() function maps the error number in errnum  that  corre‐
27       sponds to an XTI error to a language-dependent error message string and
28       returns a pointer to the string. The string pointed to will not be mod‐
29       ified  by  the  program, but may be overwritten by a subsequent call to
30       the t_strerror function. The string is  not  terminated  by  a  newline
31       character.  The  language  for  error message strings written by t_str‐
32       error() is that of the current locale. If it is English, the error mes‐
33       sage  string  describing  the  value in t_errno may be derived from the
34       comments following the t_errno codes defined in <xti.h>.  If  an  error
35       code  is unknown, and the language is English, t_strerror() returns the
36       string:
37
38         "<error>: error unknown"
39
40
41
42       where <error> is the error number supplied as  input.   In  other  lan‐
43       guages, an equivalent text is provided.
44

VALID STATES

46       ALL - apart from T_UNINIT.
47

RETURN VALUES

49       The  function  t_strerror()  returns a pointer to the generated message
50       string.
51

TLI COMPATIBILITY

53       The XTI and TLI interface definitions have common names but use differ‐
54       ent  header files. This, and other semantic differences between the two
55       interfaces are described in the subsections below.
56
57   Interface Header
58       The XTI interfaces use the header file, xti.h.  TLI  interfaces  should
59       not use this header.  They should use the header:
60         #include <tiuser.h>
61

ATTRIBUTES

63       See attributes(5)  for descriptions of the following attributes:
64
65
66
67
68       ┌─────────────────────────────┬─────────────────────────────┐
69       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
70       ├─────────────────────────────┼─────────────────────────────┤
71       │MT Level                     │Safe                         │
72       └─────────────────────────────┴─────────────────────────────┘
73