ACE_SOCK_Stream object.
More...
#include <SOCK_Connector.h>
Inheritance diagram for ACE_SOCK_Connector:

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) |
| int | 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>. | |
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 284 of file SOCK_Connector.h. |
|
|
Reimplemented in ACE_LSOCK_Connector. Definition at line 285 of file SOCK_Connector.h. |
|
|
Default constructor.
Definition at line 19 of file SOCK_Connector.inl. References ACE_TRACE.
00020 {
00021 ACE_TRACE ("ACE_SOCK_Connector::ACE_SOCK_Connector");
00022 }
|
|
||||||||||||||||||||||||||||||||||||
|
Actively connect to a peer, producing a connected
Definition at line 301 of file SOCK_Connector.cpp. References ACE_ERROR, ACE_TEXT, ACE_TRACE, connect(), ETIME, ETIMEDOUT, EWOULDBLOCK, and LM_ERROR.
00309 {
00310 ACE_TRACE ("ACE_SOCK_Connector::ACE_SOCK_Connector");
00311
00312 if (this->connect (new_stream,
00313 remote_sap,
00314 timeout,
00315 local_sap,
00316 reuse_addr,
00317 flags,
00318 perms,
00319 protocol) == -1
00320 && timeout != 0
00321 && !(errno == EWOULDBLOCK || errno == ETIME || errno == ETIMEDOUT))
00322 ACE_ERROR ((LM_ERROR,
00323 ACE_TEXT ("%p\n"),
00324 ACE_TEXT ("ACE_SOCK_Connector::ACE_SOCK_Connector")));
00325 }
|
|
||||||||||||||||||||||||||||||||||||||||||||
|
Actively connect to a peer, producing a connected
Definition at line 328 of file SOCK_Connector.cpp. References ACE_ERROR, ACE_SOCK_GROUP, ACE_TEXT, ACE_TRACE, connect(), ETIME, ETIMEDOUT, EWOULDBLOCK, and LM_ERROR.
00338 {
00339 ACE_TRACE ("ACE_SOCK_Connector::ACE_SOCK_Connector");
00340
00341 if (this->connect (new_stream,
00342 remote_sap,
00343 qos_params,
00344 timeout,
00345 local_sap,
00346 protocolinfo,
00347 g,
00348 flags,
00349 reuse_addr,
00350 perms) == -1
00351 && timeout != 0
00352 && !(errno == EWOULDBLOCK || errno == ETIME || errno == ETIMEDOUT))
00353 ACE_ERROR ((LM_ERROR,
00354 ACE_TEXT ("%p\n"),
00355 ACE_TEXT ("ACE_SOCK_Connector::ACE_SOCK_Connector")));
00356 }
|
|
|
Default dtor.
Definition at line 11 of file SOCK_Connector.inl. References ACE_TRACE.
00012 {
00013 ACE_TRACE ("ACE_SOCK_Connector::~ACE_SOCK_Connector");
00014 }
|
|
||||||||||||||||
|
Try to complete a nonblocking connection that was begun by a previous call to connect with a {0, 0} ACE_Time_Value timeout.
Definition at line 250 of file SOCK_Connector.cpp. References ACE_NONBLOCK, ACE_TRACE, ACE_SOCK_Stream::close(), ACE_IPC_SAP::disable(), ACE_Addr::get_addr(), ACE_IPC_SAP::get_handle(), ACE_Addr::get_size(), ACE_OS::getpeername(), ACE::handle_timed_complete(), and ACE_OS::sleep(). Referenced by shared_connect_finish().
00253 {
00254 ACE_TRACE ("ACE_SOCK_Connector::complete");
00255 ACE_HANDLE h = ACE::handle_timed_complete (new_stream.get_handle (),
00256 tv);
00257 // We failed to get connected.
00258 if (h == ACE_INVALID_HANDLE)
00259 {
00260 #if defined (ACE_WIN32)
00261 // Win32 has a timing problem - if you check to see if the
00262 // connection has completed too fast, it will fail - so wait
00263 // <ACE_NON_BLOCKING_BUG_DELAY> microseconds to let it catch up
00264 // then retry to see if it's a real failure.
00265 ACE_Time_Value time (0, ACE_NON_BLOCKING_BUG_DELAY);
00266 ACE_OS::sleep (time);
00267 h = ACE::handle_timed_complete (new_stream.get_handle (),
00268 tv);
00269 if (h == ACE_INVALID_HANDLE)
00270 {
00271 #endif /* ACE_WIN32 */
00272 // Save/restore errno.
00273 ACE_Errno_Guard error (errno);
00274 new_stream.close ();
00275 return -1;
00276 #if defined (ACE_WIN32)
00277 }
00278 #endif /* ACE_WIN32 */
00279 }
00280
00281 if (remote_sap != 0)
00282 {
00283 int len = remote_sap->get_size ();
00284 sockaddr *addr = reinterpret_cast<sockaddr *> (remote_sap->get_addr ());
00285 if (ACE_OS::getpeername (h,
00286 addr,
00287 &len) == -1)
00288 {
00289 // Save/restore errno.
00290 ACE_Errno_Guard error (errno);
00291 new_stream.close ();
00292 return -1;
00293 }
00294 }
00295
00296 // Start out with non-blocking disabled on the <new_stream>.
00297 new_stream.disable (ACE_NONBLOCK);
00298 return 0;
00299 }
|
|
||||||||||||||||||||||||||||||||||||||||||||
|
Actively connect to a peer, producing a connected
Definition at line 210 of file SOCK_Connector.cpp. References ACE_SOCK_GROUP, ACE_TRACE, ACE_OS::connect(), ACE_Addr::get_addr(), ACE_IPC_SAP::get_handle(), ACE_Addr::get_size(), ACE_Addr::get_type(), shared_connect_finish(), shared_connect_start(), and shared_open().
00220 {
00221 ACE_TRACE ("ACE_SOCK_Connector::connect");
00222
00223 if (this->shared_open (new_stream,
00224 remote_sap.get_type (),
00225 0,
00226 protocolinfo,
00227 g,
00228 flags,
00229 reuse_addr) == -1)
00230 return -1;
00231 else if (this->shared_connect_start (new_stream,
00232 timeout,
00233 local_sap) == -1)
00234 return -1;
00235
00236 int result = ACE_OS::connect (new_stream.get_handle (),
00237 reinterpret_cast<sockaddr *> (remote_sap.get_addr ()),
00238 remote_sap.get_size (),
00239 qos_params);
00240
00241 return this->shared_connect_finish (new_stream,
00242 timeout,
00243 result);
00244 }
|
|
||||||||||||||||||||||||||||||||||||
|
Actively connect to a peer, producing a connected
Definition at line 178 of file SOCK_Connector.cpp. References ACE_TRACE, ACE_OS::connect(), ACE_Addr::get_addr(), ACE_IPC_SAP::get_handle(), ACE_Addr::get_size(), ACE_Addr::get_type(), shared_connect_finish(), shared_connect_start(), and shared_open(). Referenced by ACE_SOCK_Connector(), ACE_LSOCK_Connector::connect(), ACE_TSS_Connection::make_TSS_TYPE(), ACE_Pipe::open(), ACE_Name_Proxy::open(), and ACE_Log_Msg_IPC::open().
00186 {
00187 ACE_TRACE ("ACE_SOCK_Connector::connect");
00188
00189 if (this->shared_open (new_stream,
00190 remote_sap.get_type (),
00191 protocol,
00192 reuse_addr) == -1)
00193 return -1;
00194 else if (this->shared_connect_start (new_stream,
00195 timeout,
00196 local_sap) == -1)
00197 return -1;
00198
00199 int result = ACE_OS::connect (new_stream.get_handle (),
00200 reinterpret_cast<sockaddr *> (remote_sap.get_addr ()),
00201 remote_sap.get_size ());
00202
00203 return this->shared_connect_finish (new_stream,
00204 timeout,
00205 result);
00206 }
|
|
|
Dump the state of an object.
Reimplemented in ACE_LSOCK_Connector. Definition at line 25 of file SOCK_Connector.cpp. References ACE_TRACE. Referenced by ACE_Name_Proxy::dump().
00026 {
00027 #if defined (ACE_HAS_DUMP)
00028 ACE_TRACE ("ACE_SOCK_Connector::dump");
00029 #endif /* ACE_HAS_DUMP */
00030 }
|
|
|
Resets any event associations on this handle.
Definition at line 25 of file SOCK_Connector.inl.
00026 {
00027 #if defined (ACE_HAS_WINSOCK2) && (ACE_HAS_WINSOCK2 != 0)
00028 // Reset the event association
00029 return ::WSAEventSelect ((SOCKET) handle,
00030 0,
00031 0);
00032 #else /* !defined ACE_HAS_WINSOCK2 */
00033 ACE_UNUSED_ARG (handle);
00034 return 0;
00035 #endif /* ACE_WIN32 */
00036 }
|
|
||||||||||||||||
|
Perform operations that must be called after <ACE_OS::connect>.
Definition at line 108 of file SOCK_Connector.cpp. References ACE_NONBLOCK, ACE_TRACE, ACE_SOCK_Stream::close(), complete(), ACE_IPC_SAP::disable(), EINPROGRESS, EISCONN, ETIME, ETIMEDOUT, EWOULDBLOCK, ACE_IPC_SAP::get_handle(), ACE::handle_timed_complete(), ACE_Time_Value::sec(), and ACE_Time_Value::usec(). Referenced by connect().
00111 {
00112 ACE_TRACE ("ACE_SOCK_Connector::shared_connect_finish");
00113 // Save/restore errno.
00114 ACE_Errno_Guard error (errno);
00115
00116 if (result == -1 && timeout != 0)
00117 {
00118 // Check whether the connection is in progress.
00119 if (error == EINPROGRESS || error == EWOULDBLOCK)
00120 {
00121 // This expression checks if we were polling.
00122 if (timeout->sec () == 0
00123 && timeout->usec () == 0)
00124 {
00125 #if defined(ACE_WIN32)
00126 // In order to detect when the socket that has been
00127 // bound to is in TIME_WAIT we need to do the connect
00128 // (which will always return EWOULDBLOCK) and then do an
00129 // ACE::handle_timed_complete() (with timeout==0,
00130 // i.e. poll). This will do a select() on the handle
00131 // which will immediately return with the handle in an
00132 // error state. The error code is then retrieved with
00133 // getsockopt(). Good sockets however will return from
00134 // the select() with ETIME - in this case return
00135 // EWOULDBLOCK so the wait strategy can complete the
00136 // connection.
00137 if(ACE::handle_timed_complete (new_stream.get_handle (),
00138 timeout) == ACE_INVALID_HANDLE)
00139 {
00140 int const tmp = errno;
00141 if (tmp != ETIME)
00142 {
00143 error = tmp;
00144 }
00145 else
00146 error = EWOULDBLOCK;
00147 }
00148 else
00149 result = 0;
00150 #else /* ACE_WIN32 */
00151 error = EWOULDBLOCK;
00152 #endif /* ACE_WIN32 */
00153 }
00154 // Wait synchronously using timeout.
00155 else if (this->complete (new_stream,
00156 0,
00157 timeout) == -1)
00158 error = errno;
00159 else
00160 return 0;
00161 }
00162 }
00163
00164 // EISCONN is treated specially since this routine may be used to
00165 // check if we are already connected.
00166 if (result != -1 || error == EISCONN)
00167 // Start out with non-blocking disabled on the <new_stream>.
00168 new_stream.disable (ACE_NONBLOCK);
00169 else if (!(error == EWOULDBLOCK || error == ETIMEDOUT))
00170 new_stream.close ();
00171
00172 return result;
00173 }
|
|
||||||||||||||||
|
Perform operations that must be called before <ACE_OS::connect>.
Definition at line 77 of file SOCK_Connector.cpp. References ACE_NONBLOCK, ACE_TRACE, ACE_OS::bind(), ACE_SOCK_Stream::close(), ACE_IPC_SAP::enable(), ACE_Addr::get_addr(), ACE_IPC_SAP::get_handle(), and ACE_Addr::get_size(). Referenced by connect().
00080 {
00081 ACE_TRACE ("ACE_SOCK_Connector::shared_connect_start");
00082
00083 if (local_sap != ACE_Addr::sap_any)
00084 {
00085 sockaddr *laddr = reinterpret_cast<sockaddr *> (local_sap.get_addr ());
00086 int size = local_sap.get_size ();
00087
00088 if (ACE_OS::bind (new_stream.get_handle (),
00089 laddr,
00090 size) == -1)
00091 {
00092 // Save/restore errno.
00093 ACE_Errno_Guard error (errno);
00094 new_stream.close ();
00095 return -1;
00096 }
00097 }
00098
00099 // Enable non-blocking, if required.
00100 if (timeout != 0
00101 && new_stream.enable (ACE_NONBLOCK) == -1)
00102 return -1;
00103 else
00104 return 0;
00105 }
|
|
||||||||||||||||||||||||||||||||
|
Perform operations that ensure the socket is opened using QoS-enabled semantics. Definition at line 52 of file SOCK_Connector.cpp. References ACE_SOCK_GROUP, ACE_TRACE, ACE_IPC_SAP::get_handle(), ACE_SOCK::open(), and SOCK_STREAM.
00059 {
00060 ACE_TRACE ("ACE_SOCK_Connector::shared_open");
00061
00062 // Only open a new socket if we don't already have a valid handle.
00063 if (new_stream.get_handle () == ACE_INVALID_HANDLE
00064 && new_stream.open (SOCK_STREAM,
00065 protocol_family,
00066 protocol,
00067 protocolinfo,
00068 g,
00069 flags,
00070 reuse_addr) == -1)
00071 return -1;
00072 else
00073 return 0;
00074 }
|
|
||||||||||||||||||||
|
Perform operations that ensure the socket is opened using BSD-style semantics (no QoS). Definition at line 33 of file SOCK_Connector.cpp. References ACE_TRACE, ACE_IPC_SAP::get_handle(), ACE_SOCK::open(), and SOCK_STREAM. Referenced by connect().
00037 {
00038 ACE_TRACE ("ACE_SOCK_Connector::shared_open");
00039
00040 // Only open a new socket if we don't already have a valid handle.
00041 if (new_stream.get_handle () == ACE_INVALID_HANDLE
00042 && new_stream.open (SOCK_STREAM,
00043 protocol_family,
00044 protocol,
00045 reuse_addr) == -1)
00046 return -1;
00047 else
00048 return 0;
00049 }
|
|
|
Declare the dynamic allocation hooks.
Reimplemented in ACE_LSOCK_Connector. Definition at line 291 of file SOCK_Connector.h. |
1.3.6