[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    t_look(3N) manual page Table of Contents

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)

Notes

This interface is safe in multithreaded applications.

Table of Contents