t_rcvconnect(3N)  UNIX System V(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(3N).  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(3N)] 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:

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



10/89                                                                    Page 1

t_rcvconnect(3N)  UNIX System V(Networking Support Utilities)  t_rcvconnect(3N)


      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(3N), 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                                                                    10/89