Name
t_look - look at the current event on a transport endpoint
Syntax
#include <tiuser.h>
int t_look(fd)
int fd;
Description
This function returns the current event on the transport
endpoint specified by fd. This function enables a transport
provider to notify a transport user of an asynchronous event
when the user is issuing functions in synchronous mode.
Certain events require immediate notification of the user
and are indicated by a specific error, TLOOK, on the current
or next function to be executed.
This function also enables a transport user to poll a
transport endpoint periodically for asynchronous events.
On failure, t_errno may be set to one of the following:
[TBADF] The specified file descriptor does not refer
to a transport endpoint.
[TSYSERR] A system error has occurred during execution
of this function.
See Also
t_open(NSL).
Network Programmer's Guide.
Diagnostics
Upon success, t_look returns a value that indicates which of
the allowable events has occurred, or returns zero if no
event exists. One of the following events is returned:
T_LISTEN connection indication received
T_CONNECT connect confirmation received
T_DATA normal data received
T_EXDATA expedited data received
T_DISCONNECT disconnect received
T_ERROR fatal error indication
T_UDERR datagram error indication
T_ORDREL orderly release indication
On failure, -1 is returned, and t_errno is set to indicate
the error.
Standards Conformance
t_look is conformant with:
AT&T SVID Issue 2, Select Code 307-127.
(printed 6/18/89)