Looks at the current event on a transport end point.
Transport Layer Interface Library (libtli.a)
The t_look subroutine returns the current event on the transport end point specified by the fd parameter. This subroutine 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 subroutine executed.
This subroutine also enables a transport user to poll a transport end point periodically for asynchronous events.
|fd||Specifies the transport end point.|
On successful completion, the
t_look subroutine returns a value that indicates which of the
allowable events has occurred, or returns a value of 0 if no event
exists. One of the following events is returned:
|T_CONNECT||Indicates connect confirmation received.|
|T_DATA||Indicates normal data received.|
|T_DISCONNECT||Indicates disconnect received.|
|T_ERROR||Indicates fatal error.|
|T_EXDATA||Indicates expedited data received.|
|T_LISTEN||Indicates connection indication received.|
|T_ORDREL||Indicates orderly release.|
|T_UDERR||Indicates datagram error.|
If the t_look subroutine is unsuccessful, a value of -1 is returned, and the t_errno variable is set to indicate the error.
If unsuccessful, the
t_errno variable is set to one of the following:
|TBADF||The specified file descriptor does not refer to a transport end point.|
|TSYSERR||A system error has occurred during execution of this function.|
This subroutine is part of Base Operating System (BOS) Runtime.
The t_open subroutine.
List of Streams Programming References and STREAMS Overview in AIX 5L Version 5.1 Communications Programming Concepts.