Manual page for t_look(3N)
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.
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97
