t_rcvconnect(3N)        LIBRARY FUNCTIONS        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  communica-
     tion  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 esta-
     blished 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 avail-
     able,  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



                                                                1

t_rcvconnect(3N)        LIBRARY FUNCTIONS        t_rcvconnect(3N)



     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  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  exe-
                         cution 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.




















                                                                2