t_look(3N)
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).
CX/UX Networking Reference Manual
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
T_GODATA Flow control restrictions on normal data flow have been lifted and normal data may be sent again.
T_GOEXDATA Flow control restrictions on expedited data flow have been lifted and expedited data may be sent again.
On failure, −1 is returned and t_errno is set to indicate the error.
CX/UX Networking