t_look(3N) t_look(3N)
NAME
tlook - look at the current event on a transport endpoint
SYNOPSIS
#include <sys/tiuser.h>
int tlook(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 noti-
fication 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 end-
point periodically for asynchronous events.
On failure, terrno 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.
DIAGNOSTICS
Upon success, tlook 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:
TLISTEN connection indication received
TCONNECT connect confirmation received
TDATA normal data received
TEXDATA expedited data received
TDISCONNECT disconnect received
TUDERR datagram error indication
TORDREL orderly release indication
On failure, -1 is returned and terrno is set to indicate the error.
SEE ALSO
topen(3N).
Page 1 Reliant UNIX 5.44 Printed 11/98