t_look(3N) — DG/UX R4.11MU05



t_look(3N)                     DG/UX R4.11MU05                    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.


Licensed material--property of copyright holder(s)
Museum
