Query: t_look
OS: ultrix
Section: 3xti
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
t_look(3xti) t_look(3xti) Name t_look - look at the current event on a transport endpoint Syntax #include <xti.h> int t_look(fd) int fd; Arguments fd Identifies the transport endpoint where the current event is returned. 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 notifica- tion 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. -------------------------------------- Parameters Before Call After Call -------------------------------------- fd x / -------------------------------------- Return Values Upon successful completion, 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. Normal data can be sent again. T_GOEXDATA Flow control restrictions on expedited data flow have been lifted. Expedited data can be sent again. On failure, -1 is returned, and t_errno is set to indicate the error. Diagnostics On failure, t_errno is 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(3xti), t_snd(3xti), t_sndudata(3xti) t_look(3xti)