t_look(3N)              NETWORK FUNCTIONS              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 transport 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).
     UNIX System V Network 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_UDERR            datagram error indication

     T_ORDREL           orderly release indication

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



            Last change: Networking Support Utilities           1