t_look(3N) UNIX System V(Networking Support Utilities) t_look(3N)
NAME
tlook - look at the current event on a transport endpoint
SYNOPSIS
#include <tiuser.h>
int tlook(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, 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.
SEE ALSO
topen(3N)
Programmer's Guide: Networking Interfaces
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
10/89 Page 1
t_look(3N) UNIX System V(Networking Support Utilities) t_look(3N)
On failure, -1 is returned and terrno is set to indicate the error.
Page 2 10/89