Defines a factory that actively connects to a remote IP address and TCP port, creating a new ACE_SOCK_Stream
object.
More...
#include <SOCK_Connector.h>
Public Types | |
typedef ACE_INET_Addr | PEER_ADDR |
typedef ACE_SOCK_Stream | PEER_STREAM |
Public Member Functions | |
ACE_SOCK_Connector (void) | |
Default constructor. | |
ACE_SOCK_Connector (ACE_SOCK_Stream &new_stream, const ACE_Addr &remote_sap, const ACE_Time_Value *timeout=0, const ACE_Addr &local_sap=ACE_Addr::sap_any, int reuse_addr=0, int flags=0, int perms=0, int protocol=0) | |
ACE_SOCK_Connector (ACE_SOCK_Stream &new_stream, const ACE_Addr &remote_sap, ACE_QoS_Params qos_params, const ACE_Time_Value *timeout=0, const ACE_Addr &local_sap=ACE_Addr::sap_any, ACE_Protocol_Info *protocolinfo=0, ACE_SOCK_GROUP g=0, u_long flags=0, int reuse_addr=0, int perms=0) | |
int | connect (ACE_SOCK_Stream &new_stream, const ACE_Addr &remote_sap, const ACE_Time_Value *timeout=0, const ACE_Addr &local_sap=ACE_Addr::sap_any, int reuse_addr=0, int flags=0, int perms=0, int protocol=0) |
int | connect (ACE_SOCK_Stream &new_stream, const ACE_Addr &remote_sap, ACE_QoS_Params qos_params, const ACE_Time_Value *timeout=0, const ACE_Addr &local_sap=ACE_Addr::sap_any, ACE_Protocol_Info *protocolinfo=0, ACE_SOCK_GROUP g=0, u_long flags=0, int reuse_addr=0, int perms=0) |
~ACE_SOCK_Connector (void) | |
Default dtor. | |
int | complete (ACE_SOCK_Stream &new_stream, ACE_Addr *remote_sap=0, const ACE_Time_Value *timeout=0) |
bool | reset_new_handle (ACE_HANDLE handle) |
Resets any event associations on this handle. | |
void | dump (void) const |
Dump the state of an object. | |
Public Attributes | |
ACE_ALLOC_HOOK_DECLARE | |
Declare the dynamic allocation hooks. | |
Protected Member Functions | |
int | shared_open (ACE_SOCK_Stream &new_stream, int protocol_family, int protocol, int reuse_addr) |
int | shared_open (ACE_SOCK_Stream &new_stream, int protocol_family, int protocol, ACE_Protocol_Info *protocolinfo, ACE_SOCK_GROUP g, u_long flags, int reuse_addr) |
int | shared_connect_start (ACE_SOCK_Stream &new_stream, const ACE_Time_Value *timeout, const ACE_Addr &local_sap) |
Perform operations that must be called before <ACE_OS::connect>. | |
int | shared_connect_finish (ACE_SOCK_Stream &new_stream, const ACE_Time_Value *timeout, int result) |
Perform operations that must be called after <ACE_OS::connect>. |
Defines a factory that actively connects to a remote IP address and TCP port, creating a new ACE_SOCK_Stream
object.
The ACE_SOCK_Connector
doesn't have a socket of its own, i.e., it simply "borrows" the one from the ACE_SOCK_Stream
that's being connected. The reason for this is that the underlying socket API doesn't use a factory socket to connect data mode sockets. Therefore, there's no need to inherit ACE_SOCK_Connector
from ACE_SOCK
. A nice side-effect of this is that ACE_SOCK_Connector
objects do not store state so they can be used reentrantly in multithreaded programs.
Definition at line 43 of file SOCK_Connector.h.
Reimplemented in ACE_LSOCK_Connector.
Definition at line 276 of file SOCK_Connector.h.
Reimplemented in ACE_LSOCK_Connector.
Definition at line 277 of file SOCK_Connector.h.
ACE_SOCK_Connector::ACE_SOCK_Connector | ( | void | ) |
Default constructor.
Definition at line 19 of file SOCK_Connector.inl.
{ ACE_TRACE ("ACE_SOCK_Connector::ACE_SOCK_Connector"); }
ACE_SOCK_Connector::ACE_SOCK_Connector | ( | ACE_SOCK_Stream & | new_stream, | |
const ACE_Addr & | remote_sap, | |||
const ACE_Time_Value * | timeout = 0 , |
|||
const ACE_Addr & | local_sap = ACE_Addr::sap_any , |
|||
int | reuse_addr = 0 , |
|||
int | flags = 0 , |
|||
int | perms = 0 , |
|||
int | protocol = 0 | |||
) |
Actively connect to a peer, producing a connected ACE_SOCK_Stream
object if the connection succeeds.
new_stream | The ACE_SOCK_Stream object that will be connected to the peer. | |
remote_sap | The address that we are trying to connect to. The protocol family of remote_sap is used for the connected socket. That is, if remote_sap contains an IPv6 address, a socket with family PF_INET6 will be used, else it will be PF_INET. | |
timeout | Pointer to an ACE_Time_Value object with amount of time to wait to connect. If the pointer is 0 then the call blocks until the connection attempt is complete, whether it succeeds or fails. If *timeout == {0, 0} then the connection is done using nonblocking mode. In this case, if the connection can't be made immediately, this method returns -1 and errno == EWOULDBLOCK. If *timeout > {0, 0} then this is the maximum amount of time to wait before timing out; if the specified amount of time passes before the connection is made, this method returns -1 and errno == ETIME. Note the difference between this case and when a blocking connect is attempted that TCP times out - in the latter case, errno will be ETIMEDOUT. | |
local_sap | (optional) The local address to bind to. If it's the default value of ACE_Addr::sap_any then the OS will choose an unused port. | |
reuse_addr | (optional) If the value is 1, the local address (local_sap ) is reused, even if it hasn't been cleaned up yet. | |
flags | Ignored. | |
perms | Ignored. | |
protocol | (optional) If value is 0, default SOCK_STREAM protocol is selected by kernel (typically TCP). |
Definition at line 307 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::ACE_SOCK_Connector"); if (this->connect (new_stream, remote_sap, timeout, local_sap, reuse_addr, flags, perms, protocol) == -1 && timeout != 0 && !(errno == EWOULDBLOCK || errno == ETIME || errno == ETIMEDOUT)) ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("ACE_SOCK_Connector::ACE_SOCK_Connector"))); }
ACE_SOCK_Connector::ACE_SOCK_Connector | ( | ACE_SOCK_Stream & | new_stream, | |
const ACE_Addr & | remote_sap, | |||
ACE_QoS_Params | qos_params, | |||
const ACE_Time_Value * | timeout = 0 , |
|||
const ACE_Addr & | local_sap = ACE_Addr::sap_any , |
|||
ACE_Protocol_Info * | protocolinfo = 0 , |
|||
ACE_SOCK_GROUP | g = 0 , |
|||
u_long | flags = 0 , |
|||
int | reuse_addr = 0 , |
|||
int | perms = 0 | |||
) |
Actively connect to a peer, producing a connected ACE_SOCK_Stream
object if the connection succeeds.
new_stream | The ACE_SOCK_Stream object that will be connected to the peer. | |
remote_sap | The address that we are trying to connect to. The protocol family of remote_sap is used for the connected socket. That is, if remote_sap contains an IPv6 address, a socket with family PF_INET6 will be used, else it will be PF_INET. | |
qos_params | Contains QoS parameters that are passed to the IntServ (RSVP) and DiffServ protocols. |
timeout | Pointer to an ACE_Time_Value object with amount of time to wait to connect. If the pointer is 0 then the call blocks until the connection attempt is complete, whether it succeeds or fails. If *timeout == {0, 0} then the connection is done using nonblocking mode. In this case, if the connection can't be made immediately, this method returns -1 and errno == EWOULDBLOCK. If *timeout > {0, 0} then this is the maximum amount of time to wait before timing out; if the specified amount of time passes before the connection is made, this method returns -1 and errno == ETIME. Note the difference between this case and when a blocking connect is attempted that TCP times out - in the latter case, errno will be ETIMEDOUT. | |
local_sap | (optional) The local address to bind to. If it's the default value of ACE_Addr::sap_any then the OS will choose an unused port. | |
reuse_addr | (optional) If the value is 1, the local address (local_sap ) is reused, even if it hasn't been cleaned up yet. | |
flags | Ignored. | |
perms | Ignored. |
Definition at line 334 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::ACE_SOCK_Connector"); if (this->connect (new_stream, remote_sap, qos_params, timeout, local_sap, protocolinfo, g, flags, reuse_addr, perms) == -1 && timeout != 0 && !(errno == EWOULDBLOCK || errno == ETIME || errno == ETIMEDOUT)) ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("ACE_SOCK_Connector::ACE_SOCK_Connector"))); }
ACE_SOCK_Connector::~ACE_SOCK_Connector | ( | void | ) |
Default dtor.
Definition at line 11 of file SOCK_Connector.inl.
{ ACE_TRACE ("ACE_SOCK_Connector::~ACE_SOCK_Connector"); }
int ACE_SOCK_Connector::complete | ( | ACE_SOCK_Stream & | new_stream, | |
ACE_Addr * | remote_sap = 0 , |
|||
const ACE_Time_Value * | timeout = 0 | |||
) |
Try to complete a nonblocking connection that was begun by a previous call to connect with a {0, 0} ACE_Time_Value timeout.
new_stream | The ACE_SOCK_Stream object that will be connected to the peer. | |
remote_sap | If non-0, it points to the ACE_INET_Addr object that will contain the address of the connected peer. | |
timeout | Same values and return value possibilites as for connect(). |
Definition at line 256 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::complete"); ACE_HANDLE h = ACE::handle_timed_complete (new_stream.get_handle (), tv); // We failed to get connected. if (h == ACE_INVALID_HANDLE) { #if defined (ACE_WIN32) // Win32 has a timing problem - if you check to see if the // connection has completed too fast, it will fail - so wait // <ACE_NON_BLOCKING_BUG_DELAY> microseconds to let it catch up // then retry to see if it's a real failure. ACE_Time_Value time (0, ACE_NON_BLOCKING_BUG_DELAY); ACE_OS::sleep (time); h = ACE::handle_timed_complete (new_stream.get_handle (), tv); if (h == ACE_INVALID_HANDLE) { #endif /* ACE_WIN32 */ // Save/restore errno. ACE_Errno_Guard error (errno); new_stream.close (); return -1; #if defined (ACE_WIN32) } #endif /* ACE_WIN32 */ } if (remote_sap != 0) { int len = remote_sap->get_size (); sockaddr *addr = reinterpret_cast<sockaddr *> (remote_sap->get_addr ()); if (ACE_OS::getpeername (h, addr, &len) == -1) { // Save/restore errno. ACE_Errno_Guard error (errno); new_stream.close (); return -1; } } // Start out with non-blocking disabled on the <new_stream>. new_stream.disable (ACE_NONBLOCK); return 0; }
int ACE_SOCK_Connector::connect | ( | ACE_SOCK_Stream & | new_stream, | |
const ACE_Addr & | remote_sap, | |||
ACE_QoS_Params | qos_params, | |||
const ACE_Time_Value * | timeout = 0 , |
|||
const ACE_Addr & | local_sap = ACE_Addr::sap_any , |
|||
ACE_Protocol_Info * | protocolinfo = 0 , |
|||
ACE_SOCK_GROUP | g = 0 , |
|||
u_long | flags = 0 , |
|||
int | reuse_addr = 0 , |
|||
int | perms = 0 | |||
) |
Actively connect to a peer, producing a connected ACE_SOCK_Stream
object if the connection succeeds.
new_stream | The ACE_SOCK_Stream object that will be connected to the peer. | |
remote_sap | The address that we are trying to connect to. The protocol family of remote_sap is used for the connected socket. That is, if remote_sap contains an IPv6 address, a socket with family PF_INET6 will be used, else it will be PF_INET. | |
qos_params | Contains QoS parameters that are passed to the IntServ (RSVP) and DiffServ protocols. |
timeout | Pointer to an ACE_Time_Value object with amount of time to wait to connect. If the pointer is 0 then the call blocks until the connection attempt is complete, whether it succeeds or fails. If *timeout == {0, 0} then the connection is done using nonblocking mode. In this case, if the connection can't be made immediately, this method returns -1 and errno == EWOULDBLOCK. If *timeout > {0, 0} then this is the maximum amount of time to wait before timing out; if the specified amount of time passes before the connection is made, this method returns -1 and errno == ETIME. Note the difference between this case and when a blocking connect is attempted that TCP times out - in the latter case, errno will be ETIMEDOUT. | |
local_sap | (optional) The local address to bind to. If it's the default value of ACE_Addr::sap_any then the OS will choose an unused port. | |
reuse_addr | (optional) If the value is 1, the local address (local_sap ) is reused, even if it hasn't been cleaned up yet. | |
flags | Ignored. | |
perms | Ignored. |
Definition at line 216 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::connect"); if (this->shared_open (new_stream, remote_sap.get_type (), 0, protocolinfo, g, flags, reuse_addr) == -1) return -1; else if (this->shared_connect_start (new_stream, timeout, local_sap) == -1) return -1; int result = ACE_OS::connect (new_stream.get_handle (), reinterpret_cast<sockaddr *> (remote_sap.get_addr ()), remote_sap.get_size (), qos_params); return this->shared_connect_finish (new_stream, timeout, result); }
int ACE_SOCK_Connector::connect | ( | ACE_SOCK_Stream & | new_stream, | |
const ACE_Addr & | remote_sap, | |||
const ACE_Time_Value * | timeout = 0 , |
|||
const ACE_Addr & | local_sap = ACE_Addr::sap_any , |
|||
int | reuse_addr = 0 , |
|||
int | flags = 0 , |
|||
int | perms = 0 , |
|||
int | protocol = 0 | |||
) |
Actively connect to a peer, producing a connected ACE_SOCK_Stream
object if the connection succeeds.
new_stream | The ACE_SOCK_Stream object that will be connected to the peer. | |
remote_sap | The address that we are trying to connect to. The protocol family of remote_sap is used for the connected socket. That is, if remote_sap contains an IPv6 address, a socket with family PF_INET6 will be used, else it will be PF_INET. | |
timeout | Pointer to an ACE_Time_Value object with amount of time to wait to connect. If the pointer is 0 then the call blocks until the connection attempt is complete, whether it succeeds or fails. If *timeout == {0, 0} then the connection is done using nonblocking mode. In this case, if the connection can't be made immediately, this method returns -1 and errno == EWOULDBLOCK. If *timeout > {0, 0} then this is the maximum amount of time to wait before timing out; if the specified amount of time passes before the connection is made, this method returns -1 and errno == ETIME. Note the difference between this case and when a blocking connect is attempted that TCP times out - in the latter case, errno will be ETIMEDOUT. | |
local_sap | (optional) The local address to bind to. If it's the default value of ACE_Addr::sap_any then the OS will choose an unused port. | |
reuse_addr | (optional) If the value is 1, the local address (local_sap ) is reused, even if it hasn't been cleaned up yet. | |
flags | Ignored. | |
perms | Ignored. | |
protocol | (optional) If value is 0, default SOCK_STREAM protocol is selected by kernel (typically TCP). |
Definition at line 184 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::connect"); if (this->shared_open (new_stream, remote_sap.get_type (), protocol, reuse_addr) == -1) return -1; else if (this->shared_connect_start (new_stream, timeout, local_sap) == -1) return -1; int result = ACE_OS::connect (new_stream.get_handle (), reinterpret_cast<sockaddr *> (remote_sap.get_addr ()), remote_sap.get_size ()); return this->shared_connect_finish (new_stream, timeout, result); }
void ACE_SOCK_Connector::dump | ( | void | ) | const |
Dump the state of an object.
Reimplemented in ACE_LSOCK_Connector.
Definition at line 25 of file SOCK_Connector.cpp.
{ #if defined (ACE_HAS_DUMP) ACE_TRACE ("ACE_SOCK_Connector::dump"); #endif /* ACE_HAS_DUMP */ }
bool ACE_SOCK_Connector::reset_new_handle | ( | ACE_HANDLE | handle | ) |
Resets any event associations on this handle.
Definition at line 25 of file SOCK_Connector.inl.
{ #if defined (ACE_HAS_WINSOCK2) && (ACE_HAS_WINSOCK2 != 0) // Reset the event association return ::WSAEventSelect ((SOCKET) handle, 0, 0); #else /* !defined ACE_HAS_WINSOCK2 */ ACE_UNUSED_ARG (handle); return false; #endif /* ACE_WIN32 */ }
int ACE_SOCK_Connector::shared_connect_finish | ( | ACE_SOCK_Stream & | new_stream, | |
const ACE_Time_Value * | timeout, | |||
int | result | |||
) | [protected] |
Perform operations that must be called after <ACE_OS::connect>.
Definition at line 107 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::shared_connect_finish"); // Save/restore errno. ACE_Errno_Guard error (errno); if (result == -1 && timeout != 0) { // Check whether the connection is in progress. if (error == EINPROGRESS || error == EWOULDBLOCK) { // This expression checks if we were polling. if (*timeout == ACE_Time_Value::zero) { #if defined(ACE_WIN32) // In order to detect when the socket that has been // bound to is in TIME_WAIT we need to do the connect // (which will always return EWOULDBLOCK) and then do an // ACE::handle_timed_complete() (with timeout==0, // i.e. poll). This will do a select() on the handle // which will immediately return with the handle in an // error state. The error code is then retrieved with // getsockopt(). Good sockets however will return from // the select() with ETIME - in this case return // EWOULDBLOCK so the wait strategy can complete the // connection. if(ACE::handle_timed_complete (new_stream.get_handle (), timeout) == ACE_INVALID_HANDLE) { int const tmp = errno; if (tmp != ETIME) { error = tmp; } else error = EWOULDBLOCK; } else result = 0; #else /* ACE_WIN32 */ error = EWOULDBLOCK; #endif /* ACE_WIN32 */ } // Wait synchronously using timeout. else if (this->complete (new_stream, 0, timeout) == -1) error = errno; else return 0; } } // EISCONN is treated specially since this routine may be used to // check if we are already connected. if (result != -1 || error == EISCONN) { // Start out with non-blocking disabled on the new_stream. result = new_stream.disable (ACE_NONBLOCK); if (result == -1) { new_stream.close (); } } else if (!(error == EWOULDBLOCK || error == ETIMEDOUT)) { new_stream.close (); } return result; }
int ACE_SOCK_Connector::shared_connect_start | ( | ACE_SOCK_Stream & | new_stream, | |
const ACE_Time_Value * | timeout, | |||
const ACE_Addr & | local_sap | |||
) | [protected] |
Perform operations that must be called before <ACE_OS::connect>.
Definition at line 77 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::shared_connect_start"); if (local_sap != ACE_Addr::sap_any) { sockaddr *laddr = reinterpret_cast<sockaddr *> (local_sap.get_addr ()); int size = local_sap.get_size (); if (ACE_OS::bind (new_stream.get_handle (), laddr, size) == -1) { // Save/restore errno. ACE_Errno_Guard error (errno); new_stream.close (); return -1; } } // Enable non-blocking, if required. if (timeout != 0 && new_stream.enable (ACE_NONBLOCK) == -1) return -1; else return 0; }
int ACE_SOCK_Connector::shared_open | ( | ACE_SOCK_Stream & | new_stream, | |
int | protocol_family, | |||
int | protocol, | |||
ACE_Protocol_Info * | protocolinfo, | |||
ACE_SOCK_GROUP | g, | |||
u_long | flags, | |||
int | reuse_addr | |||
) | [protected] |
Perform operations that ensure the socket is opened using QoS-enabled semantics.
Definition at line 52 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::shared_open"); // Only open a new socket if we don't already have a valid handle. if (new_stream.get_handle () == ACE_INVALID_HANDLE && new_stream.open (SOCK_STREAM, protocol_family, protocol, protocolinfo, g, flags, reuse_addr) == -1) return -1; else return 0; }
int ACE_SOCK_Connector::shared_open | ( | ACE_SOCK_Stream & | new_stream, | |
int | protocol_family, | |||
int | protocol, | |||
int | reuse_addr | |||
) | [protected] |
Perform operations that ensure the socket is opened using BSD-style semantics (no QoS).
Definition at line 33 of file SOCK_Connector.cpp.
{ ACE_TRACE ("ACE_SOCK_Connector::shared_open"); // Only open a new socket if we don't already have a valid handle. if (new_stream.get_handle () == ACE_INVALID_HANDLE && new_stream.open (SOCK_STREAM, protocol_family, protocol, reuse_addr) == -1) return -1; else return 0; }
Declare the dynamic allocation hooks.
Reimplemented in ACE_LSOCK_Connector.
Definition at line 283 of file SOCK_Connector.h.