t_look(3)                           CLIX                           t_look(3)



  NAME

    t_look - Look at the current event on a transport endpoint

  LIBRARY

    The Transport Layer Interface (TLI) Library (libnsl_s.a)

  SYNOPSIS

    #include <tiuser.h>

    int t_look(
      int fd );

  PARAMETERS

    fd   An integer representing a file descriptor

  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.

  RETURN VALUES

    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




  2/94 - Intergraph Corporation                                              1

  t_look(3)                           CLIX                           t_look(3)



    t_ordrel       Orderly release indication

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

  ERRORS

    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.

  RELATED INFORMATION

    Functions: t_open(3)

    AT&T UNIX System V Network Programmer's Guide




































  2                                              Intergraph Corporation - 2/94