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

NAME

6       t_errno - XTI error return value
7

SYNOPSIS

9       #include <xti.h>
10
11

DESCRIPTION

13       This error return value is part of the XTI interfaces that evolved from
14       the TLI interfaces. XTI represents the future evolution of these inter‐
15       faces.  However,  TLI  interfaces are supported for compatibility. When
16       using a TLI interface that has the same name as an  XTI  interfaces,  a
17       different  headerfile, <tiuser.h>, must be used. Refer the the TLI COM‐
18       PATIBILITY section for a description of  differences  between  the  two
19       interfaces.
20
21
22       t_errno is used by XTI functions to return error values.
23
24
25       XTI  functions  provide an error number in  t_errno which has type  int
26       and is defined in  <xti.h>. The value of  t_errno will be defined  only
27       after  a call to a XTI function for which it is explicitly stated to be
28       set and until it is changed by the next XTI function call. The value of
29       t_errno  should  only be examined when it is indicated to be valid by a
30       function's return value.  Programs  should  obtain  the  definition  of
31       t_errno by the inclusion of  <xti.h>. The practice of defining  t_errno
32       in program as  extern int t_errno is obsolescent. No XTI function  sets
33       t_errno to 0 to indicate an error.
34
35
36       It  is  unspecified  whether  t_errno  is a macro or an identifier with
37       external linkage.  It represents a modifiable  lvalue of type int. If a
38       macro definition is suppressed in order to access an actual object or a
39       program defines an identifier with name  t_errno, the behavior is unde‐
40       fined.
41
42
43       The  symbolic  values stored in  t_errno by an XTI function are defined
44       in the ERRORS sections in all relevant XTI function definition pages.
45

TLI COMPATIBILITY

47       t_errno is also used by TLI functions to return error values.
48
49
50       The XTI and TLI interface definitions have common names but use differ‐
51       ent  header files. This, and other semantic differences between the two
52       interfaces are described in the subsections below.
53
54   Interface Header
55       The XTI interfaces use the header file, <xti.h>. TLI interfaces  should
56       not use this header.  They should use the header:
57         #include <tiuser.h>
58
59   Error Description Values
60       The  t_errno  values that can be set by the XTI interface but cannot be
61       set by the TLI interface are:
62         TNOSTRUCTYPE
63         TBADNAME
64         TBADQLEN
65         TADDRBUSY
66         TINDOUT
67         TPROVMISMATCH
68         TRESADDR
69         TQFULL
70         TPROTO
71

ATTRIBUTES

73       See attributes(5) for descriptions of the following attributes:
74
75
76
77
78       ┌─────────────────────────────┬─────────────────────────────┐
79       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
80       ├─────────────────────────────┼─────────────────────────────┤
81       │MT-Level                     │MT-Safe                      │
82       └─────────────────────────────┴─────────────────────────────┘
83

SEE ALSO

85       attributes(5)
86
87
88
89SunOS 5.11                        7 May 1998                     t_errno(3NSL)
Impressum