NAME
ACE_TLI_Connector -
Defines an active connection factory for the ACE_TLI C++ wrappers.
SYNOPSIS
#include <ace/TLI_Connector.h>
class ACE_TLI_Connector : public ACE_TLI
{
public:
ACE_TLI_Connector (void);
ACE_TLI_Connector (
ACE_TLI_Stream &new_stream,
const ACE_Addr &remote_sap,
ACE_Time_Value *timeout = 0,
const ACE_Addr &local_sap = ACE_Addr::sap_any,
int reuse_addr = 0,
int flags = O_RDWR,
int perms = 0,
const char device[] = "/dev/tcp",
struct t_info *info = 0,
int rw_flag = 1,
struct netbuf *udata = 0,
struct netbuf *opt = 0
);
int connect (
ACE_TLI_Stream &new_stream,
const ACE_Addr &remote_sap,
ACE_Time_Value *timeout = 0,
const ACE_Addr &local_sap = ACE_Addr::sap_any,
int reuse_addr = 0,
int flags = O_RDWR,
int perms = 0,
const char device[] = "/dev/tcp",
struct t_info *info = 0,
int rw_flag = 1,
struct netbuf *udata = 0,
struct netbuf *opt = 0
);
int complete (
ACE_TLI_Stream &new_stream,
ACE_Addr *remote_sap,
ACE_Time_Value *tv
);
void dump (void) const;
ACE_ALLOC_HOOK_DECLARE;
};
Initialization methods.
ACE_TLI_Connector (void);
ACE_TLI_Connector (
ACE_TLI_Stream &new_stream,
const ACE_Addr &remote_sap,
ACE_Time_Value *timeout = 0,
const ACE_Addr &local_sap = ACE_Addr::sap_any,
int reuse_addr = 0,
int flags = O_RDWR,
int perms = 0,
const char device[] = "/dev/tcp",
struct t_info *info = 0,
int rw_flag = 1,
struct netbuf *udata = 0,
struct netbuf *opt = 0
);
Actively connect and produce a new_stream if things go well.
The remote_sap is the address that we are trying to connect
with. The timeout is the amount of time to wait to connect.
If it's 0 then we block indefinitely. If *timeout == {0, 0} then
the connection is done using non-blocking mode. In this case, if
the connection can't be made immediately the value of -1 is
returned with errno == EWOULDBLOCK. If *timeout {0, 0} then
this is the amount of time to wait before timing out. If the
time expires before the connection is made errno == ETIMEDOUT.
The local_sap is the value of local address to bind to. If
it's the default value of ACE_Addr::sap_any then the user is
letting the OS do the binding. If reuse_addr == 1 then the
local_addr is reused, even if it hasn't been cleanedup yet.
int connect (
ACE_TLI_Stream &new_stream,
const ACE_Addr &remote_sap,
ACE_Time_Value *timeout = 0,
const ACE_Addr &local_sap = ACE_Addr::sap_any,
int reuse_addr = 0,
int flags = O_RDWR,
int perms = 0,
const char device[] = "/dev/tcp",
struct t_info *info = 0,
int rw_flag = 1,
struct netbuf *udata = 0,
struct netbuf *opt = 0
);
Actively connect and produce a new_stream if things go well.
The remote_sap is the address that we are trying to connect
with. The timeout is the amount of time to wait to connect.
If it's 0 then we block indefinitely. If *timeout == {0, 0} then
the connection is done using non-blocking mode. In this case, if
the connection can't be made immediately the value of -1 is
returned with errno == EWOULDBLOCK. If *timeout {0, 0} then
this is the amount of time to wait before timing out. If the
time expires before the connection is made errno == ETIMEDOUT.
The local_sap is the value of local address to bind to. If
it's the default value of ACE_Addr::sap_any then the user is
letting the OS do the binding. If reuse_addr == 1 then the
local_addr is reused, even if it hasn't been cleanedup yet.
int complete (
ACE_TLI_Stream &new_stream,
ACE_Addr *remote_sap,
ACE_Time_Value *tv
);
Try to complete a non-blocking connection.
If connection completion is successful then new_stream contains
the connected ACE_SOCK_Stream. If remote_sap is non-NULL then it
will contain the address of the connected peer.
void dump (void) const;
Dump the state of an object.
ACE_ALLOC_HOOK_DECLARE;
Declare the dynamic allocation hooks.
AUTHOR
Doug Schmidt
LIBRARY
ace