t_rcvconnect(3N)      (Networking Support Utilities)       t_rcvconnect(3N)


   NAME
         trcvconnect - receive the confirmation from a connect request

   SYNOPSIS
         #include <tiuser.h>

         int trcvconnect (int fd, struct tcall *call);

   DESCRIPTION
         This function enables a calling transport user to determine the
         status of a previously sent connect request and is used in
         conjunction with tconnect to establish a connection in asynchronous
         mode.  The connection will be established on successful completion of
         this function.

         fd identifies the local transport endpoint where communication will
         be established, and call contains information associated with the
         newly established connection.  call points to a tcall structure
         which contains the following members:

               struct netbuf addr;
               struct netbuf opt;
               struct netbuf udata;
               int sequence;

         netbuf is described in intro(3).  In call, addr returns the protocol
         address associated with the responding transport endpoint, opt
         presents any protocol-specific information associated with the
         connection, udata points to optional user data that may be returned
         by the destination transport user during connection establishment,
         and sequence has no meaning for this function.

         The maxlen [see netbuf in intro(3)] field of each argument must be
         set before issuing this function to indicate the maximum size of the
         buffer for each.  However, call may be NULL, in which case no
         information is given to the user on return from trcvconnect.  By
         default, trcvconnect executes in synchronous mode and waits for the
         connection to be established before returning.  On return, the addr,
         opt, and udata fields reflect values associated with the connection.

         If ONDELAY or ONONBLOCK is set (via topen or fcntl), trcvconnect
         executes in asynchronous mode, and reduces to a poll for existing
         connect confirmations.  If none are available, trcvconnect fails and
         returns immediately without waiting for the connection to be
         established.  (See TNODATA below.)  trcvconnect must be re-issued at
         a later time to complete the connection establishment phase and
         retrieve the information returned in call.

         On failure, terrno may be set to one of the following:




   7/91                                                                 Page 1

   t_rcvconnect(3N)      (Networking Support Utilities)       t_rcvconnect(3N)


         [TBADF]             The specified file descriptor does not refer to a
                             transport endpoint.

         [TBUFOVFLW]         The number of bytes allocated for an incoming
                             argument is not sufficient to store the value of
                             that argument and the connect information to be
                             returned in call will be discarded.  The
                             provider's state, as seen by the user, will be
                             changed to DATAXFER.

         [TNODATA]           ONDELAY or ONONBLOCK was set, but a connect
                             confirmation has not yet arrived.

         [TLOOK]             An asynchronous event has occurred on this
                             transport connection and requires immediate
                             attention.

         [TNOTSUPPORT]       This function is not supported by the underlying
                             transport provider.

         [TSYSERR]           A system error has occurred during execution of
                             this function.

   SEE ALSO
         intro(3), taccept(3N), tbind(3N), tconnect(3N), tlisten(3N),
         topen(3N).
         Programmer's Guide: Networking Interfaces.

   DIAGNOSTICS
         trcvconnect returns 0 on success and -1 on failure and terrno is
         set to indicate the error.






















   Page 2                                                                 7/91