diff options
Diffstat (limited to 'ace/Sockets/SOCK.h')
-rw-r--r-- | ace/Sockets/SOCK.h | 120 |
1 files changed, 120 insertions, 0 deletions
diff --git a/ace/Sockets/SOCK.h b/ace/Sockets/SOCK.h new file mode 100644 index 00000000000..bbed708afe0 --- /dev/null +++ b/ace/Sockets/SOCK.h @@ -0,0 +1,120 @@ +/* -*- C++ -*- */ + +//============================================================================= +/** + * @file SOCK.h + * + * $Id$ + * + * @author Douglas C. Schmidt <schmidt@cs.wustl.edu> + */ +//============================================================================= + +#ifndef ACE_SOCK_H +#define ACE_SOCK_H +#include "ace/pre.h" + +#include "ace/ACE.h" + +#if !defined (ACE_LACKS_PRAGMA_ONCE) +# pragma once +#endif /* ACE_LACKS_PRAGMA_ONCE */ + +#include "ace/Addr.h" +#include "ace/IPC_SAP.h" + +/** + * @class ACE_SOCK + * + * @brief An abstract class that forms the basis for more specific + * classes, such as <ACE_SOCK_Acceptor> and <ACE_SOCK_Stream>. + * Do not instantiate this class. + * + * This class provides functions that are common to all of the + * <ACE_SOCK_*> classes. <ACE_SOCK> provides the ability to get + * and set socket options, get the local and remote addresses, + * and open and close a socket handle. + */ +class ACE_Export ACE_SOCK : public ACE_IPC_SAP +{ +public: + /// Default ctor/dtor. + ~ACE_SOCK (void); + + /// Wrapper around the <setsockopt> system call. + int set_option (int level, + int option, + void *optval, + int optlen) const; + + /// Wrapper around the <getsockopt> system call. + int get_option (int level, + int option, + void *optval, + int *optlen) const; + + /// Close down the socket handle. + int close (void); + + /// Return the local endpoint address in the referenced <ACE_Addr>. + /// Returns 0 if successful, else -1. + int get_local_addr (ACE_Addr &) const; + + /** + * Return the address of the remotely connected peer (if there is + * one), in the referenced <ACE_Addr>. Returns 0 if successful, else + * -1. + */ + int get_remote_addr (ACE_Addr &) const; + + /// Dump the state of an object. + void dump (void) const; + + /// Declare the dynamic allocation hooks. + ACE_ALLOC_HOOK_DECLARE; + + /// Wrapper around the BSD-style <socket> system call (no QoS). + int open (int type, + int protocol_family, + int protocol, + int reuse_addr); + + /// Wrapper around the QoS-enabled <WSASocket> function. + int open (int type, + int protocol_family, + int protocol, + ACE_Protocol_Info *protocolinfo, + ACE_SOCK_GROUP g, + u_long flags, + int reuse_addr); + +protected: + /// Constructor with arguments to call the BSD-style <socket> system + /// call (no QoS). + ACE_SOCK (int type, + int protocol_family, + int protocol = 0, + int reuse_addr = 0); + + /// Constructor with arguments to call the QoS-enabled <WSASocket> + /// function. + ACE_SOCK (int type, + int protocol_family, + int protocol, + ACE_Protocol_Info *protocolinfo, + ACE_SOCK_GROUP g, + u_long flags, + int reuse_addr); + + /// Default constructor is protected to prevent instances of this class + /// from being defined. + ACE_SOCK (void); + +}; + +#if !defined (ACE_LACKS_INLINE_FUNCTIONS) +#include "ace/SOCK.i" +#endif /* ACE_LACKS_INLINE_FUNCTIONS */ + +#include "ace/post.h" +#endif /* ACE_SOCK_H */ |