United States-English |
|
|
HP-UX Reference > Tt_rcvconnect(3)HP-UX 11i Version 3: February 2007 |
|
NAMEt_rcvconnect() — receive the confirmation from a connect request SYNOPSIS#include <xti.h> /* for X/OPEN Transport Interface - XTI */ /* or */ #include <tiuser.h> /* for Transport Layer Interface - TLI */ int t_rcvconnect (fd, call); int fd; struct t_call *call; DESCRIPTIONThe t_rcvconnect() function enables a calling transport user to determine the status of a previously sent connect request. t_rcvconnect() is also used in conjunction with t_connect() 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. call contains information associated with the newly established connection. call points to a t_call structure which contains the following members: struct netbuf addr; struct netbuf opt; struct netbuf udata; int sequence; The type netbuf structure is defined in the <xti.h> or <tiuser.h> header file. This structure, which is used to define buffer parameters, has the following members:
In call, addr returns the protocol address associated with the responding transport endpoint. opt presents any protocol-specific information associated with the connection. For XTI over the OSI transport provider, struct isoco_options should be used. For TLI, see the documentation for the transport provider being used. udata points to optional user data that may be returned by the destination transport user during connection establishment. sequence has no meaning for this function. The maxlen 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 a null pointer, in which case no information is given to the user on return from t_rcvconnect(). By default, t_rcvconnect() 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 t_open() or fcntl()), t_rcvconnect() executes in asynchronous mode, and reduces to a poll for existing connect confirmations. If none are available, t_rcvconnect() fails and returns immediately without waiting for the connection to be established. (See [TNODATA] below.) t_rcvconnect() must be re-issued at a later time to complete the connection establishment phase and retrieve the information returned in call. RETURN VALUEUpon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error. ERRORSOn failure, t_errno is set to one of the following:
SEE ALSOfcntl(2), t_accept(3), t_alloc(3), t_bind(3), t_connect(3), t_listen(3), t_open(3), thread_safety(5). |
Printable version | ||
|