1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
// -*- C++ -*-
//=============================================================================
/**
* @file Multihomed_INET_Addr.h
*
* $Id$
*
* @author Edward R. Mulholland <emulholl@atl.lmco.com>
*/
//=============================================================================
#ifndef ACE_MULTIHOMED_INET_ADDR_H
#define ACE_MULTIHOMED_INET_ADDR_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/INET_Addr.h"
#include "ace/Containers_T.h"
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
/**
* @class ACE_Multihomed_INET_Addr
*
* @brief Extends ACE_INET_Addr with support for multi-homed
* addresses.
*/
class ACE_Export ACE_Multihomed_INET_Addr : public ACE_INET_Addr
{
public:
// = Initialization methods.
/// Default constructor.
ACE_Multihomed_INET_Addr (void);
/**
* Initializes an <ACE_Multihomed_INET_Addr> from the <address>,
* which can be "ip-number:port-number" (e.g., "tango.cs.wustl.edu:1234"
* or "128.252.166.57:1234"). If there is no ':' in the <address> it
* is assumed to be a port number, with the IP address being
* INADDR_ANY.
*/
explicit ACE_Multihomed_INET_Addr (const char address[]);
/**
* Constructs an <ACE_Multihomed_INET_Addr> from a <port_number>, a
* <primary_host_name>, and an array of <secondary_host_names>.
* <size> is taken to be the length of the array. If <encode> is
* non-zero, then <port_number> is converted into network byte
* order; otherwise it is assumed to be in network byte order
* already and is passed straight through. <address_family> can be
* used to select IPv4/IPv6 if the OS has IPv6 capability
* (ACE_HAS_IPV6 is defined). To specify IPv6, use the value
* AF_INET6. To specify IPv4, use AF_INET.
*/
ACE_Multihomed_INET_Addr(u_short port_number,
const char primary_host_name[],
int encode = 1,
int address_family = AF_UNSPEC,
const char *(secondary_host_names[]) = 0,
size_t size = 0);
/**
* Constructs an <ACE_Multihomed_INET_Addr> from a @a port_number,
* a @a primary_ip_addr, and an array of @a secondary_ip_addrs. @a
* size is taken to be the length of the array. If @a encode is
* non-zero, then the port number and the IP addresses are converted
* into network byte order; otherwise they are assumed to be in
* network byte order already and are passed straight through.
*/
ACE_Multihomed_INET_Addr(u_short port_number,
ACE_UINT32 primary_ip_addr = INADDR_ANY,
int encode = 1,
const ACE_UINT32 *secondary_ip_addrs = 0,
size_t size = 0);
#if defined (ACE_HAS_WCHAR)
/**
* WCHAR versions of the methods that take char's as arguments.
*/
ACE_Multihomed_INET_Addr(u_short port_number,
const wchar_t primary_host_name[],
int encode = 1,
int address_family = AF_UNSPEC,
const wchar_t *(secondary_host_names[]) = 0,
size_t size = 0);
int set (u_short port_number,
const wchar_t primary_host_name[],
int encode = 1,
int address_family = AF_UNSPEC,
const wchar_t *(secondary_host_names[]) = 0,
size_t size = 0);
#endif /* ACE_HAS_WCHAR */
/// Use compiler-generated copy constructor.
/// Use compiler-generated assignment operator.
/// Default dtor.
~ACE_Multihomed_INET_Addr (void);
// = Direct initialization methods.
// These methods are useful after the object has been constructed.
/**
* Initializes an <ACE_Multihomed_INET_Addr> from a <port_number>, a
* <primary_host_name>, and an array of <secondary_host_names>.
* <size> is taken to be the length of the array. If <encode> is
* non-zero, then <port_number> is converted into network byte
* order; otherwise it is assumed to be in network byte order
* already and is passed straight through. <address_family> can be
* used to select IPv4/IPv6 if the OS has IPv6 capability
* (ACE_HAS_IPV6 is defined). To specify IPv6, use the value
* AF_INET6. To specify IPv4, use AF_INET.
*/
int set (u_short port_number,
const char primary_host_name[],
int encode = 1,
int address_family = AF_UNSPEC,
const char *(secondary_host_names[]) = 0,
size_t size = 0);
/**
* Initializes an <ACE_Multihomed_INET_Addr> from a @a port_number,
* a @a primary_ip_addr, and an array of @a secondary_ip_addrs. @a
* size is taken to be the length of the array. If @a encode is
* non-zero, then the port number and the IP addresses are converted
* into network byte order; otherwise they are assumed to be in
* network byte order already and are passed straight through.
*/
int set (u_short port_number,
ACE_UINT32 primary_ip_addr = INADDR_ANY,
int encode = 1,
const ACE_UINT32 *secondary_ip_addrs = 0,
size_t size = 0);
/**
* Sets the port number without affecting the host name. The port
* numbers of the primary address, and of any and all secondary
* addresses, are affected. If <encode> is enabled, then
* <port_number> is converted into network byte order, otherwise it
* is assumed to be in network byte order already and is passed
* straight through.
*/
void set_port_number (u_short,
int encode = 1);
// = Accessor methods.
/**
* Returns the number of secondary addresses.
*/
size_t get_num_secondary_addresses () const;
/**
* Initialize user-supplied array <secondary_addrs> with the current
* secondary addresses. <size> is taken as the size of this array.
*/
int get_secondary_addresses(ACE_INET_Addr *secondary_addrs,
size_t size) const;
/**
* Initialize user-supplied array <addrs> with the the current
* primary and secondary addresses. <size> is taken as the size of
* this array.
*/
void get_addresses(sockaddr_in *addrs,
size_t size) const;
#if defined (ACE_HAS_IPV6)
/// IPV6 version of the above.
void get_addresses(sockaddr_in6 *addrs,
size_t size) const;
#endif /* ACE_HAS_IPV6 */
private:
ACE_Array<ACE_INET_Addr> secondaries_;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#if defined (__ACE_INLINE__)
# include "ace/Multihomed_INET_Addr.inl"
#endif /* __ACE_INLINE__ */
#include /**/ "ace/post.h"
#endif /* ACE_MULTIHOMED_INET_ADDR_H */
|
