t_look(3nsl)

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

NAME

6       t_look - look at the current event on a transport endpoint
7

SYNOPSIS

9       #include <xti.h>
10
11
12
13       int t_look(int fd);
14
15

DESCRIPTION

17       This  routine  is part of the XTI interfaces which evolved from the TLI
18       interfaces. XTI represents the future evolution  of  these  interfaces.
19       However,  TLI  interfaces are supported for compatibility. When using a
20       TLI routine that has the same name as an  XTI  routine,  the   tiuser.h
21       header  file must be used.  Refer to the  TLI COMPATIBILITY section for
22       a description of differences between the two interfaces.
23
24
25       This function returns the current event on the transport endpoint spec‐
26       ified  by  fd.  This  function enables a transport provider to notify a
27       transport user of an asynchronous event when the user is calling  func‐
28       tions  in  synchronous mode. Certain events require immediate notifica‐
29       tion of the user and are indicated by a specific error, TLOOK,  on  the
30       current or next function to be executed.
31
32
33       This  function  also  enables a transport user to poll a transport end‐
34       point periodically for asynchronous events.
35

RETURN VALUES

37       Upon success, t_look() returns a value  that  indicates  which  of  the
38       allowable  events has occurred, or returns zero if no event exists. One
39       of the following events is returned:
40
41       T_LISTEN         Connection indication received.
42
43
44       T_CONNECT        Connect confirmation received.
45
46
47       T_DATA           Normal data received.
48
49
50       T_EXDATA         Expedited data received.
51
52
53       T_DISCONNECT     Disconnection received.
54
55
56       T_UDERR          Datagram error indication.
57
58
59       T_ORDREL         Orderly release indication.
60
61
62       T_GODATA         Flow control restrictions on normal data flow that led
63                        to  a TFLOW error have been lifted. Normal data may be
64                        sent again.
65
66
67       T_GOEXDATA       Flow control restrictions on expedited data flow  that
68                        led  to a TFLOW error have been lifted. Expedited data
69                        may be sent again.
70
71
72
73       On failure,  -1 is returned and t_errno is set to indicate the error.
74

VALID STATES

76       ALL - apart from T_UNINIT.
77

ERRORS

79       On failure, t_errno is set to one of the following:
80
81       TBADF      The specified file descriptor does not refer to a  transport
82                  endpoint.
83
84
85       TPROTO     This  error  indicates that a communication problem has been
86                  detected between XTI and the transport  provider  for  which
87                  there is no other suitable XTI error (t_errno).
88
89
90       TSYSERR    A  system  error has occurred during execution of this func‐
91                  tion.
92
93

TLI COMPATIBILITY

95       The XTI and TLI interface definitions have common names but use differ‐
96       ent  header files. This, and other semantic differences between the two
97       interfaces are described in the subsections below.
98
99   Interface Header
100       The XTI interfaces use the header file, xti.h.  TLI  interfaces  should
101       not use this header.  They should use the header:
102
103         #include <tiuser.h>
104
105
106   Return Values
107       The  return  values that are defined by the XTI interface and cannot be
108       returned by the TLI interface are:
109         T_GODATA
110         T_GOEXDATA
111
112   Error Description Values
113       The t_errno value that can be set by the XTI interface  and  cannot  be
114       set by the TLI interface is:
115         TPROTO
116

ATTRIBUTES

118       See attributes(5)  for descriptions of the following attributes:
119
120
121
122
123       ┌─────────────────────────────┬─────────────────────────────┐
124       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
125       ├─────────────────────────────┼─────────────────────────────┤
126       │MT Level                     │Safe                         │
127       └─────────────────────────────┴─────────────────────────────┘
128