diff options
Diffstat (limited to 'ACE/ace/SOCK.h')
-rw-r--r-- | ACE/ace/SOCK.h | 138 |
1 files changed, 138 insertions, 0 deletions
diff --git a/ACE/ace/SOCK.h b/ACE/ace/SOCK.h new file mode 100644 index 00000000000..d1c67cd87ff --- /dev/null +++ b/ACE/ace/SOCK.h @@ -0,0 +1,138 @@ +/* -*- 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_export.h" + +#if !defined (ACE_LACKS_PRAGMA_ONCE) +# pragma once +#endif /* ACE_LACKS_PRAGMA_ONCE */ + +#include "ace/Addr.h" +#include "ace/IPC_SAP.h" +#include "ace/OS_NS_stropts.h" + +ACE_BEGIN_VERSIONED_NAMESPACE_DECL + +/** + * @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: + + /// 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 the socket. + * This method also sets the object's handle value to ACE_INVALID_HANDLE. + * + * @return The result of closing the socket; 0 if the handle value + * was already ACE_INVALID_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 @c socket system call (no QoS). + int open (int type, + int protocol_family, + int protocol, + int reuse_addr); + + /// Wrapper around the QoS-enabled @c 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 @c 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 @c 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); + + /// Protected destructor. + /** + * Not a virtual destructor. Protected destructor to prevent + * operator delete() from being called through a base class ACE_SOCK + * pointer/reference. + */ + ~ACE_SOCK (void); + +}; + +ACE_END_VERSIONED_NAMESPACE_DECL + +#if defined (__ACE_INLINE__) +#include "ace/SOCK.inl" +#endif /* __ACE_INLINE__ */ + +#include /**/ "ace/post.h" +#endif /* ACE_SOCK_H */ |