t_rcvconnect Subroutine for X/Open Transport Interface

Purpose

Receive the confirmation from a connect request.

Library

X/Open Transport Interface Library (libxti.a)

Syntax

#include <xti.h>

int t_rcvconnect (fd, call)
int fd;
struct t_call *call;

Description

The t_rcvconnect subroutine enables a calling transport user to determine the status of a previously sent connect request and is used in conjunction with the t_connect subroutine to establish a connection in asynchronous mode. The connection is established on successful completion of this subroutine.

Parameters

Item Description

fd Identifies the local transport endpoint where communication will be established.

Item	Description
fd	Identifies the local transport endpoint where communication will be established.
call	Contains information associated with the newly established connection. The call parameter points to a t_call structure which contains the following members: `struct netbuf addr; struct netbuf opt; struct netbuf udata; int sequence;` The fields of the t_call structure are: addr Returns the protocol address associated with the responding transport endpoint. opt Presents any options associated with the connection. udata Points to optional user data that may be returned by the destination transport user during connection establishment. sequence Has no meaning for this subroutine. The maxlen field of each t_call member must be set before issuing this subroutine to indicate the maximum size of the buffer for each. However, the vale of the call parameter may be a null pointer, in which case no information is given to the user on return from the t_rcvconnect subroutine. By default, the t_rcvconnect subroutine 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 O_NONBLOCK is set (via the t_open subroutine or fcntl), the t_rcvconnect subroutine executes in asynchronous mode, and reduces to a poll for existing connect confirmations. If none are available, the t_rcvconnect subroutine fails and returns immediately without waiting for the connection to be established. (See TNODATA in "Error Codes" below.) In this case, the t_rcvconnect subroutine must be called again to complete the connection establishment phase and retrieve the information returned in the call parameter.

call

Contains information associated with the newly established connection. The call parameter points to a t_call structure which contains the following members:

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

The fields of the t_call structure are:

addr: Returns the protocol address associated with the responding transport endpoint.
opt: Presents any options associated with the connection.
udata: Points to optional user data that may be returned by the destination transport user during connection establishment.
sequence: Has no meaning for this subroutine.

The maxlen field of each t_call member must be set before issuing this subroutine to indicate the maximum size of the buffer for each. However, the vale of the call parameter may be a null pointer, in which case no information is given to the user on return from the t_rcvconnect subroutine. By default, the t_rcvconnect subroutine 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 O_NONBLOCK is set (via the t_open subroutine or fcntl), the t_rcvconnect subroutine executes in asynchronous mode, and reduces to a poll for existing connect confirmations. If none are available, the t_rcvconnect subroutine fails and returns immediately without waiting for the connection to be established. (See TNODATA in "Error Codes" below.) In this case, the t_rcvconnect subroutine must be called again to complete the connection establishment phase and retrieve the information returned in the call parameter.

Valid States

T_OUTCON

Return Values

Item	Description
0	Successful completion.
-1	t_errno is set to indicate an error.

Error Codes

On failure, t_errno is set to one of the following:

Value	Description
TBADF	The specified file descriptor does not refer to a transport endpoint.
TBUFOVFLW	The number of bytes allocated for an incoming argument (maxlen) is greater than 0 but 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 T_DATAFER.
TLOOK	An asynchronous event has occurred on the transport connection and requires immediate attention.
TNODATA	O_NONBLOCK was set, but a connect confirmation has not yet arrived.
TNOTSUPPORT	This subroutine is not supported by the underlying transport provider.
TOUTSTATE	The subroutine was issued in the wrong sequence on the transport endpoint referenced by the fd parameter.
TPROTO	This error indicates that a communication problem has been detected between the X/Open Transport Interface and the transport provider for which there is no other suitable X/Open Transport Interface (t_errno).
TSYSERR	A system error has occurred during execution of this subroutine.