*Backed out changeset 3be01fb200a5

--HG--
branch : trunk
This commit is contained in:
maximius
2009-10-17 15:51:44 -07:00
parent 26b5e033ff
commit e585187b24
2257 changed files with 103863 additions and 761 deletions
+69
View File
@@ -1,4 +1,5 @@
/* -*- C++ -*- */
//=============================================================================
/**
* @file INET_Addr.h
@@ -8,15 +9,21 @@
* @author Douglas C. Schmidt <[email protected]>
*/
//=============================================================================
#ifndef ACE_INET_ADDR_H
#define ACE_INET_ADDR_H
#include /**/ "ace/pre.h"
#include "ace/Sock_Connect.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "ace/Addr.h"
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
/**
* @class ACE_INET_Addr
*
@@ -27,12 +34,16 @@ class ACE_Export ACE_INET_Addr : public ACE_Addr
{
public:
// = Initialization methods.
/// Default constructor.
ACE_INET_Addr (void);
/// Copy constructor.
ACE_INET_Addr (const ACE_INET_Addr &);
/// Creates an ACE_INET_Addr from a sockaddr_in structure.
ACE_INET_Addr (const sockaddr_in *addr, int len);
/// Creates an ACE_INET_Addr from a @a port_number and the remote
/// @a host_name. The port number is assumed to be in host byte order.
/// To set a port already in network byte order, please @see set().
@@ -40,6 +51,7 @@ public:
ACE_INET_Addr (u_short port_number,
const char host_name[],
int address_family = AF_UNSPEC);
/**
* Initializes an ACE_INET_Addr from the @a address, which can be
* "ip-number:port-number" (e.g., "tango.cs.wustl.edu:1234" or
@@ -49,6 +61,7 @@ public:
*/
explicit ACE_INET_Addr (const char address[],
int address_family = AF_UNSPEC);
/**
* Creates an ACE_INET_Addr from a @a port_number and an Internet
* <ip_addr>. This method assumes that @a port_number and <ip_addr>
@@ -57,11 +70,13 @@ public:
*/
explicit ACE_INET_Addr (u_short port_number,
ACE_UINT32 ip_addr = INADDR_ANY);
/// Uses <getservbyname> to create an ACE_INET_Addr from a
/// <port_name>, the remote @a host_name, and the @a protocol.
ACE_INET_Addr (const char port_name[],
const char host_name[],
const char protocol[] = "tcp");
/**
* Uses <getservbyname> to create an ACE_INET_Addr from a
* <port_name>, an Internet <ip_addr>, and the @a protocol. This
@@ -70,25 +85,34 @@ public:
ACE_INET_Addr (const char port_name[],
ACE_UINT32 ip_addr,
const char protocol[] = "tcp");
#if defined (ACE_HAS_WCHAR)
ACE_INET_Addr (u_short port_number,
const wchar_t host_name[],
int address_family = AF_UNSPEC);
explicit ACE_INET_Addr (const wchar_t address[],
int address_family = AF_UNSPEC);
ACE_INET_Addr (const wchar_t port_name[],
const wchar_t host_name[],
const wchar_t protocol[] = ACE_TEXT_WIDE ("tcp"));
ACE_INET_Addr (const wchar_t port_name[],
ACE_UINT32 ip_addr,
const wchar_t protocol[] = ACE_TEXT_WIDE ("tcp"));
#endif /* ACE_HAS_WCHAR */
/// Default dtor.
~ACE_INET_Addr (void);
// = Direct initialization methods.
// These methods are useful after the object has been constructed.
/// Initializes from another ACE_INET_Addr.
int set (const ACE_INET_Addr &);
/**
* Initializes an ACE_INET_Addr from a @a port_number and the
* remote @a host_name. If @a encode is non-zero then @a port_number is
@@ -102,6 +126,7 @@ public:
const char host_name[],
int encode = 1,
int address_family = AF_UNSPEC);
/**
* Initializes an ACE_INET_Addr from a @a port_number and an Internet
* @a ip_addr. If @a encode is non-zero then the port number and IP address
@@ -115,11 +140,13 @@ public:
ACE_UINT32 ip_addr = INADDR_ANY,
int encode = 1,
int map = 0);
/// Uses <getservbyname> to initialize an ACE_INET_Addr from a
/// <port_name>, the remote @a host_name, and the @a protocol.
int set (const char port_name[],
const char host_name[],
const char protocol[] = "tcp");
/**
* Uses <getservbyname> to initialize an ACE_INET_Addr from a
* <port_name>, an <ip_addr>, and the @a protocol. This assumes that
@@ -128,6 +155,7 @@ public:
int set (const char port_name[],
ACE_UINT32 ip_addr,
const char protocol[] = "tcp");
/**
* Initializes an ACE_INET_Addr from the @a addr, which can be
* "ip-number:port-number" (e.g., "tango.cs.wustl.edu:1234" or
@@ -136,29 +164,38 @@ public:
* INADDR_ANY.
*/
int set (const char addr[], int address_family = AF_UNSPEC);
/// Creates an ACE_INET_Addr from a sockaddr_in structure.
int set (const sockaddr_in *,
int len);
#if defined (ACE_HAS_WCHAR)
int set (u_short port_number,
const wchar_t host_name[],
int encode = 1,
int address_family = AF_UNSPEC);
int set (const wchar_t port_name[],
const wchar_t host_name[],
const wchar_t protocol[] = ACE_TEXT_WIDE ("tcp"));
int set (const wchar_t port_name[],
ACE_UINT32 ip_addr,
const wchar_t protocol[] = ACE_TEXT_WIDE ("tcp"));
int set (const wchar_t addr[], int address_family = AF_UNSPEC);
#endif /* ACE_HAS_WCHAR */
/// Return a pointer to the underlying network address.
virtual void *get_addr (void) const;
int get_addr_size(void) const;
/// Set a pointer to the address.
virtual void set_addr (void *, int len);
/// Set a pointer to the address.
virtual void set_addr (void *, int len, int map);
/**
* Transform the current ACE_INET_Addr address into string format.
* If <ipaddr_format> is non-0 this produces "ip-number:port-number"
@@ -170,6 +207,7 @@ public:
virtual int addr_to_string (ACE_TCHAR buffer[],
size_t size,
int ipaddr_format = 1) const;
/**
* Initializes an ACE_INET_Addr from the @a address, which can be
* "ip-addr:port-number" (e.g., "tango.cs.wustl.edu:1234"),
@@ -181,11 +219,13 @@ public:
*/
virtual int string_to_addr (const char address[],
int address_family = AF_UNSPEC);
#if defined (ACE_HAS_WCHAR)
/*
virtual int string_to_addr (const char address[]);
*/
#endif /* ACE_HAS_WCHAR */
/**
* Sets the port number without affecting the host name. If
* @a encode is enabled then @a port_number is converted into network
@@ -194,6 +234,7 @@ public:
*/
void set_port_number (u_short,
int encode = 1);
/**
* Sets the address without affecting the port number. If
* @a encode is enabled then <ip_addr> is converted into network
@@ -208,6 +249,7 @@ public:
int len,
int encode = 1,
int map = 0);
#if (defined (__linux__) || defined (ACE_WIN32)) && defined (ACE_HAS_IPV6)
/**
* Sets the interface that should be used for this address. This only has
@@ -215,8 +257,10 @@ public:
*/
int set_interface (const char *intf_name);
#endif /* (__linux__ || ACE_WIN32) && ACE_HAS_IPV6 */
/// Return the port number, converting it into host byte-order.
u_short get_port_number (void) const;
/**
* Return the character representation of the name of the host,
* storing it in the <hostname> (which is assumed to be
@@ -226,10 +270,12 @@ public:
*/
int get_host_name (char hostname[],
size_t hostnamelen) const;
#if defined (ACE_HAS_WCHAR)
int get_host_name (wchar_t hostname[],
size_t hostnamelen) const;
#endif /* ACE_HAS_WCHAR */
/**
* Return the character representation of the hostname. This
* version is non-reentrant since it returns a pointer to a static
@@ -239,12 +285,14 @@ public:
* above.
*/
const char *get_host_name (void) const;
/**
* Return the "dotted decimal" Internet address representation of
* the hostname storing it in the @a addr (which is assumed to be
* @a addr_size bytes long). This version is reentrant.
*/
const char *get_host_addr (char *addr, int addr_size) const;
/**
* Return the "dotted decimal" Internet address representation of
* the hostname. This version is non-reentrant since it returns a
@@ -254,23 +302,31 @@ public:
* get_host_addr() described above.
*/
const char *get_host_addr (void) const;
/// Return the 4-byte IP address, converting it into host byte
/// order.
ACE_UINT32 get_ip_address (void) const;
/// Return @c true if the IP address is INADDR_ANY or IN6ADDR_ANY.
bool is_any (void) const;
/// Return @c true if the IP address is IPv4/IPv6 loopback address.
bool is_loopback (void) const;
/// Return @c true if the IP address is IPv4/IPv6 multicast address.
bool is_multicast (void) const;
#if defined (ACE_HAS_IPV6)
/// Return @c true if the IP address is IPv6 linklocal address.
bool is_linklocal (void) const;
/// Return @c true if the IP address is IPv4-mapped IPv6 address.
bool is_ipv4_mapped_ipv6 (void) const;
/// Return @c true if the IP address is IPv4-compatible IPv6 address.
bool is_ipv4_compat_ipv6 (void) const;
#endif /* ACE_HAS_IPV6 */
/**
* Returns @c true if @c this is less than @a rhs. In this context,
* "less than" is defined in terms of IP address and TCP port
@@ -278,30 +334,40 @@ public:
* in STL maps.
*/
bool operator < (const ACE_INET_Addr &rhs) const;
/// Compare two addresses for equality. The addresses are considered
/// equal if they contain the same IP address and port number.
bool operator == (const ACE_INET_Addr &SAP) const;
/// Compare two addresses for inequality.
bool operator != (const ACE_INET_Addr &SAP) const;
/// A variation of the equality operator, this method only compares the
/// IP address and ignores the port number.
bool is_ip_equal (const ACE_INET_Addr &SAP) const;
/// Computes and returns hash value.
virtual u_long hash (void) const;
/// Dump the state of an object.
void dump (void) const;
/// Declare the dynamic allocation hooks.
ACE_ALLOC_HOOK_DECLARE;
private:
/// Insure that @a hostname is properly null-terminated.
int get_host_name_i (char hostname[], size_t hostnamelen) const;
// Methods to gain access to the actual address of
// the underlying internet address structure.
void *ip_addr_pointer (void) const;
int ip_addr_size (void) const;
int determine_type (void) const;
/// Initialize underlying inet_addr_ to default values
void reset (void);
/// Underlying representation.
/// This union uses the knowledge that the two structures share the
/// first member, sa_family (as all sockaddr structures do).
@@ -313,10 +379,13 @@ private:
#endif /* ACE_HAS_IPV6 */
} inet_addr_;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#if defined (__ACE_INLINE__)
#include "ace/INET_Addr.inl"
#endif /* __ACE_INLINE__ */
#include /**/ "ace/post.h"
#endif /* ACE_INET_ADDR_H */