T_LOOK(3N)           INTERACTIVE UNIX System           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 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).
               Programmer's Guide.

          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_ERROR            fatal error indication

               T_UDERR            datagram error indication

               T_ORDREL           orderly release indication


          Rev. Networking Support Utilities                          Page 1

          T_LOOK(3N)           INTERACTIVE UNIX System           T_LOOK(3N)



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





















































          Rev. Networking Support Utilities                          Page 2