NAME

t_look − look at the current event on a transport endpoint

SYNOPSIS

cc [ flag ... ] file ... −lnsl [ library ... ]

#include <tiuser.h>

int t_look(int fildes);

MT-LEVEL

MT-Safe

DESCRIPTION

This function returns the current event on the transport endpoint specified by fildes.  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. 

RETURN VALUES

Upon success, t_look() returns a value that indicates which of the allowable events has occurred.  Otherwise, t_look() 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, t_errno is set to indicate the error, and possibly errno is set. 

ERRORS

On failure, t_errno will 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, errno will be set to the specific error. 

SEE ALSO

t_open(3N)

SunOS 5.1 Network Interfaces Programmer’s Guide

NOTES

This interface is safe in multithreaded applications. 

SunOS 5.2  —  Last change: 22 Jan 1993