TLOOK(3N-SVR4)     RISC/os Reference Manual      TLOOK(3N-SVR4)



NAME
     t_look - look at the current event on a transport endpoint

SYNOPSIS
     #include <tiuser.h>

     int tlook(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 tran-
     sport 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).

DIAGNOSTICS
     Upon success, tlook 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





                        Printed 11/19/92                   Page 1

TLOOK(3N-SVR4)     RISC/os Reference Manual      TLOOK(3N-SVR4)



     On failure, -1 is returned and t_errno is set to indicate
     the error.





















































 Page 2                 Printed 11/19/92