t_look(S) (TLI/XTI) 6 January 1993 t_look(S) Name t_look - look at the current event on a transport endpoint Syntax TLI syntax cc . . . -lnsls #include <sys/tiuser.h> int t_look (fd) int fd; XTI syntax cc . . . -lxti #include <xti.h> int t_look (fd) int fd; Description This function returns the current event on the transport endpoint speci- fied by fd. This function enables a transport provider to notify a transport user of an asynchronous event when the user is issuing func- tions 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. Diagnostics On failure, terrno may be set to one of the following: [TBADF] The specified file descriptor does not refer to a trans- port endpoint. [TSYSERR] A system error occurred during execution of this function. When this error code, errno is set to EPROTO indicating a protocol error such as an illegal message. Return value Upon success, tlook returns a value that indicates which of the allow- able events has occurred, or returns zero if no event exists. One of the following events is returned: TCONNECT connect confirmation received TDATA normal data received TDISCONNECT disconnect received TERROR fatal error indication TEXDATA expedited data received TLISTEN connection indication received TORDREL orderly release indication TUDERR datagram error indication On failure, -1 is returned, and terrno is set to indicate the error. See also topen(S), Standards conformance tlook is conformant with: AT&T SVID Issue 2; X/Open Portability Guide, Issue 3, 1989; and Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2).