address.h 8.75 KB
Newer Older
1
2
/* Copyright (c) 2003-2004, Roger Dingledine
 * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
3
 * Copyright (c) 2007-2013, The Tor Project, Inc. */
4
5
6
7
8
9
10
/* See LICENSE for licensing information */

/**
 * \file address.h
 * \brief Headers for address.h
 **/

11
12
#ifndef TOR_ADDRESS_H
#define TOR_ADDRESS_H
13
14
15
16
17

#include "orconfig.h"
#include "torint.h"
#include "compat.h"

18
19
/** The number of bits from an address to consider while doing a masked
 * comparison. */
20
typedef uint8_t maskbits_t;
21

22
23
24
25
26
27
28
struct in_addr;
/** Holds an IPv4 or IPv6 address.  (Uses less memory than struct
 * sockaddr_storage.) */
typedef struct tor_addr_t
{
  sa_family_t family;
  union {
Nick Mathewson's avatar
Nick Mathewson committed
29
30
    uint32_t dummy_; /* This field is here so we have something to initialize
                      * with a reliable cross-platform type. */
31
32
33
34
35
    struct in_addr in_addr;
    struct in6_addr in6_addr;
  } addr;
} tor_addr_t;

36
37
38
39
40
41
42
/** Holds an IP address and a TCP/UDP port.  */
typedef struct tor_addr_port_t
{
  tor_addr_t addr;
  uint16_t port;
} tor_addr_port_t;

43
#define TOR_ADDR_NULL {AF_UNSPEC, {0}}
44

45
static INLINE const struct in6_addr *tor_addr_to_in6(const tor_addr_t *a);
46
47
48
49
50
static INLINE uint32_t tor_addr_to_ipv4n(const tor_addr_t *a);
static INLINE uint32_t tor_addr_to_ipv4h(const tor_addr_t *a);
static INLINE uint32_t tor_addr_to_mapped_ipv4h(const tor_addr_t *a);
static INLINE sa_family_t tor_addr_family(const tor_addr_t *a);
static INLINE const struct in_addr *tor_addr_to_in(const tor_addr_t *a);
51
static INLINE int tor_addr_eq_ipv4h(const tor_addr_t *a, uint32_t u);
52

53
socklen_t tor_addr_to_sockaddr(const tor_addr_t *a, uint16_t port,
54
                               struct sockaddr *sa_out, socklen_t len);
55
56
int tor_addr_from_sockaddr(tor_addr_t *a, const struct sockaddr *sa,
                           uint16_t *port_out);
57
void tor_addr_make_unspec(tor_addr_t *a);
58
void tor_addr_make_null(tor_addr_t *a, sa_family_t family);
59
char *tor_sockaddr_to_str(const struct sockaddr *sa);
60

61
62
/** Return an in6_addr* equivalent to <b>a</b>, or NULL if <b>a</b> is not
 * an IPv6 address. */
63
64
65
66
67
68
static INLINE const struct in6_addr *
tor_addr_to_in6(const tor_addr_t *a)
{
  return a->family == AF_INET6 ? &a->addr.in6_addr : NULL;
}

69
70
71
72
/** Given an IPv6 address <b>x</b>, yield it as an array of uint8_t.
 *
 * Requires that <b>x</b> is actually an IPv6 address.
 */
73
#define tor_addr_to_in6_addr8(x) tor_addr_to_in6(x)->s6_addr
74
75
76
77
/** Given an IPv6 address <b>x</b>, yield it as an array of uint16_t.
 *
 * Requires that <b>x</b> is actually an IPv6 address.
 */
78
#define tor_addr_to_in6_addr16(x) S6_ADDR16(*tor_addr_to_in6(x))
79
80
81
82
/** Given an IPv6 address <b>x</b>, yield it as an array of uint32_t.
 *
 * Requires that <b>x</b> is actually an IPv6 address.
 */
83
84
#define tor_addr_to_in6_addr32(x) S6_ADDR32(*tor_addr_to_in6(x))

85
86
/** Return an IPv4 address in network order for <b>a</b>, or 0 if
 * <b>a</b> is not an IPv4 address. */
87
88
89
90
91
static INLINE uint32_t
tor_addr_to_ipv4n(const tor_addr_t *a)
{
  return a->family == AF_INET ? a->addr.in_addr.s_addr : 0;
}
92
93
/** Return an IPv4 address in host order for <b>a</b>, or 0 if
 * <b>a</b> is not an IPv4 address. */
94
95
96
97
98
static INLINE uint32_t
tor_addr_to_ipv4h(const tor_addr_t *a)
{
  return ntohl(tor_addr_to_ipv4n(a));
}
99
/** Given an IPv6 address, return its mapped IPv4 address in host order, or
100
101
102
 * 0 if <b>a</b> is not an IPv6 address.
 *
 * (Does not check whether the address is really a mapped address */
103
104
105
static INLINE uint32_t
tor_addr_to_mapped_ipv4h(const tor_addr_t *a)
{
106
  return a->family == AF_INET6 ? ntohl(tor_addr_to_in6_addr32(a)[3]) : 0;
107
}
108
109
/** Return the address family of <b>a</b>.  Possible values are:
 * AF_INET6, AF_INET, AF_UNSPEC. */
110
111
112
113
114
static INLINE sa_family_t
tor_addr_family(const tor_addr_t *a)
{
  return a->family;
}
115
116
/** Return an in_addr* equivalent to <b>a</b>, or NULL if <b>a</b> is not
 * an IPv4 address. */
117
118
119
120
121
static INLINE const struct in_addr *
tor_addr_to_in(const tor_addr_t *a)
{
  return a->family == AF_INET ? &a->addr.in_addr : NULL;
}
122
123
/** Return true iff <b>a</b> is an IPv4 address equal to the host-ordered
 * address in <b>u</b>. */
124
125
126
127
128
static INLINE int
tor_addr_eq_ipv4h(const tor_addr_t *a, uint32_t u)
{
  return a->family == AF_INET ? (tor_addr_to_ipv4h(a) == u) : 0;
}
129

130
131
132
133
134
135
136
137
/** Length of a buffer that you need to allocate to be sure you can encode
 * any tor_addr_t.
 *
 * This allows enough space for
 *   "[ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255]",
 * plus a terminating NUL.
 */
#define TOR_ADDR_BUF_LEN 48
138
139
140

int tor_addr_lookup(const char *name, uint16_t family, tor_addr_t *addr_out);
char *tor_dup_addr(const tor_addr_t *addr) ATTR_MALLOC;
George Kadianakis's avatar
George Kadianakis committed
141
142
143
144
145
146
147

/** Wrapper function of fmt_addr_impl(). It does not decorate IPv6
 *  addresses. */
#define fmt_addr(a) fmt_addr_impl((a), 0)
/** Wrapper function of fmt_addr_impl(). It decorates IPv6
 *  addresses. */
#define fmt_and_decorate_addr(a) fmt_addr_impl((a), 1)
148
const char *fmt_addr_impl(const tor_addr_t *addr, int decorate);
David Fifield's avatar
David Fifield committed
149
const char *fmt_addrport(const tor_addr_t *addr, uint16_t port);
150
const char * fmt_addr32(uint32_t addr);
151
int get_interface_address6(int severity, sa_family_t family, tor_addr_t *addr);
152

153
154
155
156
/** Flag to specify how to do a comparison between addresses.  In an "exact"
 * comparison, addresses are equivalent only if they are in the same family
 * with the same value.  In a "semantic" comparison, IPv4 addresses match all
 * IPv6 encodings of those addresses. */
157
158
159
160
161
162
163
typedef enum {
  CMP_EXACT,
  CMP_SEMANTIC,
} tor_addr_comparison_t;

int tor_addr_compare(const tor_addr_t *addr1, const tor_addr_t *addr2,
                     tor_addr_comparison_t how);
164
int tor_addr_compare_masked(const tor_addr_t *addr1, const tor_addr_t *addr2,
165
                            maskbits_t mask, tor_addr_comparison_t how);
166
167
168
/** Return true iff a and b are the same address.  The comparison is done
 * "exactly". */
#define tor_addr_eq(a,b) (0==tor_addr_compare((a),(b),CMP_EXACT))
169

170
uint64_t tor_addr_hash(const tor_addr_t *addr);
171
int tor_addr_is_v4(const tor_addr_t *addr);
172
173
174
int tor_addr_is_internal_(const tor_addr_t *ip, int for_listening,
                          const char *filename, int lineno);
#define tor_addr_is_internal(addr, for_listening) \
175
  tor_addr_is_internal_((addr), (for_listening), SHORT_FILE__, __LINE__)
176
177
178
179

/** Longest length that can be required for a reverse lookup name. */
/* 32 nybbles, 32 dots, 8 characters of "ip6.arpa", 1 NUL: 73 characters. */
#define REVERSE_LOOKUP_NAME_BUF_LEN 73
180
int tor_addr_to_PTR_name(char *out, size_t outlen,
181
                                    const tor_addr_t *addr);
182
int tor_addr_parse_PTR_name(tor_addr_t *result, const char *address,
183
184
                                       int family, int accept_regular);

185
int tor_addr_port_lookup(const char *s, tor_addr_t *addr_out,
186
                        uint16_t *port_out);
187
188
#define TAPMP_EXTENDED_STAR 1
int tor_addr_parse_mask_ports(const char *s, unsigned flags,
189
190
                              tor_addr_t *addr_out, maskbits_t *mask_out,
                              uint16_t *port_min_out, uint16_t *port_max_out);
191
const char * tor_addr_to_str(char *dest, const tor_addr_t *addr, size_t len,
192
                             int decorate);
193
int tor_addr_parse(tor_addr_t *addr, const char *src);
194
void tor_addr_copy(tor_addr_t *dest, const tor_addr_t *src);
195
void tor_addr_copy_tight(tor_addr_t *dest, const tor_addr_t *src);
196
197
198
199
200
void tor_addr_from_ipv4n(tor_addr_t *dest, uint32_t v4addr);
/** Set <b>dest</b> to the IPv4 address encoded in <b>v4addr</b> in host
 * order. */
#define tor_addr_from_ipv4h(dest, v4addr)       \
  tor_addr_from_ipv4n((dest), htonl(v4addr))
201
void tor_addr_from_ipv6_bytes(tor_addr_t *dest, const char *bytes);
202
/** Set <b>dest</b> to the IPv4 address incoded in <b>in</b>. */
203
204
#define tor_addr_from_in(dest, in) \
  tor_addr_from_ipv4n((dest), (in)->s_addr);
205
void tor_addr_from_in6(tor_addr_t *dest, const struct in6_addr *in6);
206
207
208
int tor_addr_is_null(const tor_addr_t *addr);
int tor_addr_is_loopback(const tor_addr_t *addr);

209
210
211
int tor_addr_port_split(int severity, const char *addrport,
                        char **address_out, uint16_t *port_out);

212
213
214
int tor_addr_port_parse(int severity, const char *addrport,
                        tor_addr_t *address_out, uint16_t *port_out);

215
216
int tor_addr_hostname_is_local(const char *name);

217
/* IPv4 helpers */
Sebastian Hahn's avatar
Sebastian Hahn committed
218
int is_internal_IP(uint32_t ip, int for_listening);
219
int addr_port_lookup(int severity, const char *addrport, char **address,
220
221
222
223
                    uint32_t *addr, uint16_t *port_out);
int parse_port_range(const char *port, uint16_t *port_min_out,
                     uint16_t *port_max_out);
int addr_mask_get_bits(uint32_t mask);
224
225
/** Length of a buffer to allocate to hold the results of tor_inet_ntoa.*/
#define INET_NTOA_BUF_LEN 16
226
227
228
229
int tor_inet_ntoa(const struct in_addr *in, char *buf, size_t buf_len);
char *tor_dup_ip(uint32_t addr) ATTR_MALLOC;
int get_interface_address(int severity, uint32_t *addr);

Linus Nordberg's avatar
Linus Nordberg committed
230
231
tor_addr_port_t *tor_addr_port_new(const tor_addr_t *addr, uint16_t port);

232
233
#endif