t_look(3N) (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
7/91 Page 1
t_look(3N) (Networking Support Utilities) t_look(3N)
TORDREL orderly release indication
On failure, -1 is returned and terrno is set to indicate the error.
Page 2 7/91