t_look(3N) — Amiga System V Release 4 Version 2.03



t_look(3N)              NETWORK FUNCTIONS              t_look(3N)



NAME
     tlook - 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 transport endpoint periodically
     for asynchronous events.  On failure, terrno 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
     topen(3N).
     UNIX System V Network Programmer's Guide.

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:

     TLISTEN           connection indication received

     TCONNECT          connect confirmation received

     TDATA             normal data received

     TEXDATA           expedited data received

     TDISCONNECT       disconnect received

     TUDERR            datagram error indication

     TORDREL           orderly release indication

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



            Last change: Networking Support Utilities           1
Museum
