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
|
/*
* libjingle
* Copyright 2004--2005, Google Inc.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
* 3. The name of the author may not be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
* EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef __SOCKETADDRESS_H__
#define __SOCKETADDRESS_H__
#include "talk/base/basictypes.h"
#include <string>
#undef SetPort
namespace cricket {
// Records an IP address and port, which are 32 and 16 bit integers,
// respectively, both in <b>host byte-order</b>.
class SocketAddress {
public:
// Creates a missing / unknown address.
SocketAddress();
// Creates the address with the given host and port. If use_dns is true,
// the hostname will be immediately resolved to an IP (which may block for
// several seconds if DNS is not available). Alternately, set use_dns to
// false, and then call Resolve() to complete resolution later, or use
// SetResolvedIP to set the IP explictly.
SocketAddress(const std::string& hostname, int port = 0, bool use_dns = true);
// Creates the address with the given IP and port.
SocketAddress(uint32 ip, int port);
// Creates a copy of the given address.
SocketAddress(const SocketAddress& addr);
// Replaces our address with the given one.
SocketAddress& operator =(const SocketAddress& addr);
// Changes the IP of this address to the given one, and clears the hostname.
void SetIP(uint32 ip);
// Changes the hostname of this address to the given one.
// Calls Resolve and returns the result.
bool SetIP(const std::string& hostname, bool use_dns = true);
// Sets the IP address while retaining the hostname. Useful for bypassing
// DNS for a pre-resolved IP.
void SetResolvedIP(uint32 ip);
// Changes the port of this address to the given one.
void SetPort(int port);
// Returns the IP address.
uint32 ip() const;
// Returns the port part of this address.
uint16 port() const;
// Returns the IP address in dotted form.
std::string IPAsString() const;
// Returns the port as a string
std::string PortAsString() const;
// Returns a display version of the IP/port.
std::string ToString() const;
// Determines whether this represents a missing / any address.
bool IsAny() const;
// Synomym for missing / any.
bool IsNil() const { return IsAny(); }
// Determines whether the IP address refers to the local host, i.e. within
// the range 127.0.0.0/8.
bool IsLocalIP() const;
// Determines whether the IP address is in one of the private ranges:
// 127.0.0.0/8 10.0.0.0/8 192.168.0.0/16 172.16.0.0/12.
bool IsPrivateIP() const;
// Determines whether the hostname has been resolved to an IP
bool IsUnresolved() const;
// Attempt to resolve a hostname to IP address.
// Returns false if resolution is required but failed.
// 'force' will cause re-resolution of hostname.
//
bool Resolve(bool force = false, bool use_dns = true);
// Determines whether this address is identical to the given one.
bool operator ==(const SocketAddress& addr) const;
// Compares based on IP and then port.
bool operator <(const SocketAddress& addr) const;
// Determines whether this address has the same IP as the one given.
bool EqualIPs(const SocketAddress& addr) const;
// Deteremines whether this address has the same port as the one given.
bool EqualPorts(const SocketAddress& addr) const;
// Hashes this address into a small number.
size_t Hash() const;
// Returns the size of this address when written.
size_t Size_() const;
// Writes this address into the given buffer.
void Write_(char* buf, int len) const;
// Reads this address from the given buffer.
void Read_(const char* buf, int len);
// Converts the IP address given in compact form into dotted form.
static std::string IPToString(uint32 ip);
// Converts the IP address given in dotted form into compact form.
// Without 'use_dns', only dotted names (A.B.C.D) are resolved.
static uint32 StringToIP(const std::string& str, bool use_dns = true);
private:
std::string hostname_;
uint32 ip_;
uint16 port_;
// Initializes the address to missing / any.
void Zero();
};
} // namespace cricket
#endif // __SOCKETADDRESS_H__
|
