t_rcvconnect(3N)                 DG/UX 5.4.2                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:

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

       [TBUFOVFLW]         The number of bytes allocated for an incoming



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

t_rcvconnect(3N)                 DG/UX 5.4.2                t_rcvconnect(3N)


                           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).
       UNIX System V Network Programmer's Guide.

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






























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