t_look(3xti)

t_look -- check for asynchronous event on a transport endpoint

Synopsis

cc [options] file -lnsl

#include <xti.h>

int t_look(int fd);

Description

This function is an TLI/XTI local management routine used to return the current asynchronous event on the transport endpoint specified by fd. The event indicated reflects the service type of the transport provider. t_look enables a transport provider to notify a transport user, when the user is issuing functions in synchronous mode, if an asynchronous event has occurred on the specified endpoint.

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.

Values returned by t_look include the following:

T_LISTEN: A connect indication has arrived at the transport endpoint.
T_CONNECT: A connect confirmation has arrived at the transport endpoint. (When the server accepts a connect request, the confirmation is generated.)
T_DATA: User data has arrived at the transport endpoint.
T_EXDATA: Expedited user data has arrived at the transport endpoint.
T_DISCONNECT: A notification that the connection was aborted or that the server did not accept a connect request (disconnect indication) has arrived at the transport endpoint.
T_UDERR: Notification that a datagram error occurred (unitdata error indication) has arrived at the transport endpoint.
T_ORDREL: A request for the orderly release of a connection (orderly release indication) has arrived at the transport endpoint.
T_GODATA: Notification that it is again possible to send user data has arrived at the transport endpoint.
T_GOEXDATA: Notification that it is again possible to send expedited user data has arrived at the transport endpoint.

Parameters

fd: the file descriptor for the local transport endpoint associated with the current event.

State transitions

t_look may be issued from any valid state except T_UNINIT and has no effect on the state.

Files

/usr/lib/libxti.so: X/Open^® Transport Interface Library (shared object)
/usr/lib/libnsl.so: Network Services Library (shared object)

Return values

On success, t_look returns 0 if no event exists or the value that indicates which event exists. On failure, -1 is returned and t_errno is set to indicate the error.

Errors

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.
TPROTO: A communication problem has been detected with the transport provider and there is no other value of t_errno to describe the error condition.

References

t_open(3xti), t_snd(3xti), t_sndudata(3xti)