NAME

t_look - look at the current event on a transport endpoint

SYNOPSIS

#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(3N).
UNIX System V 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_UDERR            datagram error indication

T_ORDREL           orderly release indication

On failure, -1 is returned and t_errno is set to indicate the error.