1 /**
2  * @file
3  * IP address API (common IPv4 and IPv6)
4  */
5 
6 /*
7  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without modification,
11  * are permitted provided that the following conditions are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright notice,
14  *    this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright notice,
16  *    this list of conditions and the following disclaimer in the documentation
17  *    and/or other materials provided with the distribution.
18  * 3. The name of the author may not be used to endorse or promote products
19  *    derived from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
22  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
23  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
24  * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
26  * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
29  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
30  * OF SUCH DAMAGE.
31  *
32  * This file is part of the lwIP TCP/IP stack.
33  *
34  * Author: Adam Dunkels <adam@sics.se>
35  *
36  */
37 #ifndef LWIP_HDR_IP_ADDR_H
38 #define LWIP_HDR_IP_ADDR_H
39 
40 #include "lwip/opt.h"
41 #include "lwip/def.h"
42 
43 #include "lwip/ip4_addr.h"
44 #include "lwip/ip6_addr.h"
45 
46 #ifdef __cplusplus
47 extern "C" {
48 #endif
49 
50 /** @ingroup ipaddr
51  * IP address types for use in ip_addr_t.type member.
52  * @see tcp_new_ip_type(), udp_new_ip_type(), raw_new_ip_type().
53  */
54 enum lwip_ip_addr_type {
55   /** IPv4 */
56   IPADDR_TYPE_V4 =   0U,
57   /** IPv6 */
58   IPADDR_TYPE_V6 =   6U,
59   /** IPv4+IPv6 ("dual-stack") */
60   IPADDR_TYPE_ANY = 46U
61 };
62 
63 #if LWIP_IPV4 && LWIP_IPV6
64 /**
65  * @ingroup ipaddr
66  * A union struct for both IP version's addresses.
67  * ATTENTION: watch out for its size when adding IPv6 address scope!
68  */
69 typedef struct ip_addr {
70   union {
71     ip6_addr_t ip6;
72     ip4_addr_t ip4;
73   } u_addr;
74   /** @ref lwip_ip_addr_type */
75   u8_t type;
76 } ip_addr_t;
77 
78 extern const ip_addr_t ip_addr_any_type;
79 
80 /** @ingroup ip4addr */
81 #define IPADDR4_INIT(u32val)          { { { { u32val, 0ul, 0ul, 0ul } IPADDR6_ZONE_INIT } }, IPADDR_TYPE_V4 }
82 /** @ingroup ip4addr */
83 #define IPADDR4_INIT_BYTES(a,b,c,d)   IPADDR4_INIT(PP_HTONL(LWIP_MAKEU32(a,b,c,d)))
84 
85 /** @ingroup ip6addr */
86 #define IPADDR6_INIT(a, b, c, d)      { { { { a, b, c, d } IPADDR6_ZONE_INIT } }, IPADDR_TYPE_V6 }
87 /** @ingroup ip6addr */
88 #define IPADDR6_INIT_HOST(a, b, c, d) { { { { PP_HTONL(a), PP_HTONL(b), PP_HTONL(c), PP_HTONL(d) } IPADDR6_ZONE_INIT } }, IPADDR_TYPE_V6 }
89 
90 /** @ingroup ipaddr */
91 #define IP_IS_ANY_TYPE_VAL(ipaddr)    (IP_GET_TYPE(&ipaddr) == IPADDR_TYPE_ANY)
92 /** @ingroup ipaddr */
93 #define IPADDR_ANY_TYPE_INIT          { { { { 0ul, 0ul, 0ul, 0ul } IPADDR6_ZONE_INIT } }, IPADDR_TYPE_ANY }
94 
95 /** @ingroup ip4addr */
96 #define IP_IS_V4_VAL(ipaddr)          (IP_GET_TYPE(&ipaddr) == IPADDR_TYPE_V4)
97 /** @ingroup ip6addr */
98 #define IP_IS_V6_VAL(ipaddr)          (IP_GET_TYPE(&ipaddr) == IPADDR_TYPE_V6)
99 /** @ingroup ip4addr */
100 #define IP_IS_V4(ipaddr)              (((ipaddr) == NULL) || IP_IS_V4_VAL(*(ipaddr)))
101 /** @ingroup ip6addr */
102 #define IP_IS_V6(ipaddr)              (((ipaddr) != NULL) && IP_IS_V6_VAL(*(ipaddr)))
103 
104 #define IP_SET_TYPE_VAL(ipaddr, iptype) do { (ipaddr).type = (iptype); }while(0)
105 #define IP_SET_TYPE(ipaddr, iptype)     do { if((ipaddr) != NULL) { IP_SET_TYPE_VAL(*(ipaddr), iptype); }}while(0)
106 #define IP_GET_TYPE(ipaddr)           ((ipaddr)->type)
107 
108 #define IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr) (IP_GET_TYPE(&pcb->local_ip) == IP_GET_TYPE(ipaddr))
109 #define IP_ADDR_PCB_VERSION_MATCH(pcb, ipaddr) (IP_IS_ANY_TYPE_VAL(pcb->local_ip) || IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr))
110 
111 /** @ingroup ip6addr
112  * Convert generic ip address to specific protocol version
113  */
114 #define ip_2_ip6(ipaddr)   (&((ipaddr)->u_addr.ip6))
115 /** @ingroup ip4addr
116  * Convert generic ip address to specific protocol version
117  */
118 #define ip_2_ip4(ipaddr)   (&((ipaddr)->u_addr.ip4))
119 
120 /** @ingroup ip4addr */
121 #define IP_ADDR4(ipaddr,a,b,c,d)      do { IP4_ADDR(ip_2_ip4(ipaddr),a,b,c,d); \
122                                            IP_SET_TYPE_VAL(*(ipaddr), IPADDR_TYPE_V4); } while(0)
123 /** @ingroup ip6addr */
124 #define IP_ADDR6(ipaddr,i0,i1,i2,i3)  do { IP6_ADDR(ip_2_ip6(ipaddr),i0,i1,i2,i3); \
125                                            IP_SET_TYPE_VAL(*(ipaddr), IPADDR_TYPE_V6); } while(0)
126 /** @ingroup ip6addr */
127 #define IP_ADDR6_HOST(ipaddr,i0,i1,i2,i3)  IP_ADDR6(ipaddr,PP_HTONL(i0),PP_HTONL(i1),PP_HTONL(i2),PP_HTONL(i3))
128 
129 /** @ingroup ipaddr */
130 #define ip_addr_copy(dest, src)      do{ IP_SET_TYPE_VAL(dest, IP_GET_TYPE(&src)); if(IP_IS_V6_VAL(src)){ \
131   ip6_addr_copy(*ip_2_ip6(&(dest)), *ip_2_ip6(&(src))); }else{ \
132   ip4_addr_copy(*ip_2_ip4(&(dest)), *ip_2_ip4(&(src))); }}while(0)
133 /** @ingroup ip6addr */
134 #define ip_addr_copy_from_ip6(dest, src)      do{ \
135   ip6_addr_copy(*ip_2_ip6(&(dest)), src); IP_SET_TYPE_VAL(dest, IPADDR_TYPE_V6); }while(0)
136 /** @ingroup ip6addr */
137 #define ip_addr_copy_from_ip6_packed(dest, src)      do{ \
138   ip6_addr_copy_from_packed(*ip_2_ip6(&(dest)), src); IP_SET_TYPE_VAL(dest, IPADDR_TYPE_V6); }while(0)
139 /** @ingroup ip4addr */
140 #define ip_addr_copy_from_ip4(dest, src)      do{ \
141   ip4_addr_copy(*ip_2_ip4(&(dest)), src); IP_SET_TYPE_VAL(dest, IPADDR_TYPE_V4); }while(0)
142 /** @ingroup ip4addr */
143 #define ip_addr_set_ip4_u32(ipaddr, val)  do{if(ipaddr){ip4_addr_set_u32(ip_2_ip4(ipaddr), val); \
144   IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }}while(0)
145 /** @ingroup ip4addr */
146 #define ip_addr_get_ip4_u32(ipaddr)  (((ipaddr) && IP_IS_V4(ipaddr)) ? \
147   ip4_addr_get_u32(ip_2_ip4(ipaddr)) : 0)
148 /** @ingroup ipaddr */
149 #define ip_addr_set(dest, src) do{ IP_SET_TYPE(dest, IP_GET_TYPE(src)); if(IP_IS_V6(src)){ \
150   ip6_addr_set(ip_2_ip6(dest), ip_2_ip6(src)); }else{ \
151   ip4_addr_set(ip_2_ip4(dest), ip_2_ip4(src)); }}while(0)
152 /** @ingroup ipaddr */
153 #define ip_addr_set_ipaddr(dest, src) ip_addr_set(dest, src)
154 /** @ingroup ipaddr */
155 #define ip_addr_set_zero(ipaddr)     do{ \
156   ip6_addr_set_zero(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, 0); }while(0)
157 /** @ingroup ip5addr */
158 #define ip_addr_set_zero_ip4(ipaddr)     do{ \
159   ip6_addr_set_zero(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }while(0)
160 /** @ingroup ip6addr */
161 #define ip_addr_set_zero_ip6(ipaddr)     do{ \
162   ip6_addr_set_zero(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V6); }while(0)
163 /** @ingroup ipaddr */
164 #define ip_addr_set_any(is_ipv6, ipaddr)      do{if(is_ipv6){ \
165   ip6_addr_set_any(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V6); }else{ \
166   ip4_addr_set_any(ip_2_ip4(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }}while(0)
167 /** @ingroup ipaddr */
168 #define ip_addr_set_loopback(is_ipv6, ipaddr) do{if(is_ipv6){ \
169   ip6_addr_set_loopback(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V6); }else{ \
170   ip4_addr_set_loopback(ip_2_ip4(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }}while(0)
171 /** @ingroup ipaddr */
172 #define ip_addr_set_hton(dest, src)  do{if(IP_IS_V6(src)){ \
173   ip6_addr_set_hton(ip_2_ip6(ipaddr), (src)); IP_SET_TYPE(dest, IPADDR_TYPE_V6); }else{ \
174   ip4_addr_set_hton(ip_2_ip4(ipaddr), (src)); IP_SET_TYPE(dest, IPADDR_TYPE_V4); }}while(0)
175 /** @ingroup ipaddr */
176 #define ip_addr_get_network(target, host, netmask) do{if(IP_IS_V6(host)){ \
177   ip4_addr_set_zero(ip_2_ip4(target)); IP_SET_TYPE(target, IPADDR_TYPE_V6); } else { \
178   ip4_addr_get_network(ip_2_ip4(target), ip_2_ip4(host), ip_2_ip4(netmask)); IP_SET_TYPE(target, IPADDR_TYPE_V4); }}while(0)
179 /** @ingroup ipaddr */
180 #define ip_addr_netcmp(addr1, addr2, mask) ((IP_IS_V6(addr1) && IP_IS_V6(addr2)) ? \
181   0 : \
182   ip4_addr_netcmp(ip_2_ip4(addr1), ip_2_ip4(addr2), mask))
183 /** @ingroup ipaddr */
184 #define ip_addr_cmp(addr1, addr2)    ((IP_GET_TYPE(addr1) != IP_GET_TYPE(addr2)) ? 0 : (IP_IS_V6_VAL(*(addr1)) ? \
185   ip6_addr_cmp(ip_2_ip6(addr1), ip_2_ip6(addr2)) : \
186   ip4_addr_cmp(ip_2_ip4(addr1), ip_2_ip4(addr2))))
187 /** @ingroup ipaddr */
188 #define ip_addr_isany(ipaddr)        ((IP_IS_V6(ipaddr)) ? \
189   ip6_addr_isany(ip_2_ip6(ipaddr)) : \
190   ip4_addr_isany(ip_2_ip4(ipaddr)))
191 /** @ingroup ipaddr */
192 #define ip_addr_isany_val(ipaddr)        ((IP_IS_V6_VAL(ipaddr)) ? \
193   ip6_addr_isany_val(*ip_2_ip6(&(ipaddr))) : \
194   ip4_addr_isany_val(*ip_2_ip4(&(ipaddr))))
195 /** @ingroup ipaddr */
196 #define ip_addr_isbroadcast(ipaddr, netif) ((IP_IS_V6(ipaddr)) ? \
197   0 : \
198   ip4_addr_isbroadcast(ip_2_ip4(ipaddr), netif))
199 /** @ingroup ipaddr */
200 #define ip_addr_ismulticast(ipaddr)  ((IP_IS_V6(ipaddr)) ? \
201   ip6_addr_ismulticast(ip_2_ip6(ipaddr)) : \
202   ip4_addr_ismulticast(ip_2_ip4(ipaddr)))
203 /** @ingroup ipaddr */
204 #define ip_addr_isloopback(ipaddr)  ((IP_IS_V6(ipaddr)) ? \
205   ip6_addr_isloopback(ip_2_ip6(ipaddr)) : \
206   ip4_addr_isloopback(ip_2_ip4(ipaddr)))
207 /** @ingroup ipaddr */
208 #define ip_addr_islinklocal(ipaddr)  ((IP_IS_V6(ipaddr)) ? \
209   ip6_addr_islinklocal(ip_2_ip6(ipaddr)) : \
210   ip4_addr_islinklocal(ip_2_ip4(ipaddr)))
211 #define ip_addr_debug_print(debug, ipaddr) do { if(IP_IS_V6(ipaddr)) { \
212   ip6_addr_debug_print(debug, ip_2_ip6(ipaddr)); } else { \
213   ip4_addr_debug_print(debug, ip_2_ip4(ipaddr)); }}while(0)
214 #define ip_addr_debug_print_val(debug, ipaddr) do { if(IP_IS_V6_VAL(ipaddr)) { \
215   ip6_addr_debug_print_val(debug, *ip_2_ip6(&(ipaddr))); } else { \
216   ip4_addr_debug_print_val(debug, *ip_2_ip4(&(ipaddr))); }}while(0)
217 /** @ingroup ipaddr */
218 #define ipaddr_ntoa(addr)   (((addr) == NULL) ? "NULL" : \
219   ((IP_IS_V6(addr)) ? ip6addr_ntoa(ip_2_ip6(addr)) : ip4addr_ntoa(ip_2_ip4(addr))))
220 /** @ingroup ipaddr */
221 #define ipaddr_ntoa_r(addr, buf, buflen)   (((addr) == NULL) ? "NULL" : \
222   ((IP_IS_V6(addr)) ? ip6addr_ntoa_r(ip_2_ip6(addr), buf, buflen) : ip4addr_ntoa_r(ip_2_ip4(addr), buf, buflen)))
223 int ipaddr_aton(const char *cp, ip_addr_t *addr);
224 
225 /** @ingroup ipaddr */
226 #define IPADDR_STRLEN_MAX   IP6ADDR_STRLEN_MAX
227 
228 /** @ingroup ipaddr */
229 #define ip4_2_ipv4_mapped_ipv6(ip6addr, ip4addr) do { \
230   (ip6addr)->addr[3] = (ip4addr)->addr; \
231   (ip6addr)->addr[2] = PP_HTONL(0x0000FFFFUL); \
232   (ip6addr)->addr[1] = 0; \
233   (ip6addr)->addr[0] = 0; \
234   ip6_addr_clear_zone(ip6addr); } while(0);
235 
236 /** @ingroup ipaddr */
237 #define unmap_ipv4_mapped_ipv6(ip4addr, ip6addr) \
238   (ip4addr)->addr = (ip6addr)->addr[3];
239 
240 #define IP46_ADDR_ANY(type) (((type) == IPADDR_TYPE_V6)? IP6_ADDR_ANY : IP4_ADDR_ANY)
241 
242 #else /* LWIP_IPV4 && LWIP_IPV6 */
243 
244 #define IP_ADDR_PCB_VERSION_MATCH(addr, pcb)         1
245 #define IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr) 1
246 
247 #if LWIP_IPV4
248 
249 typedef ip4_addr_t ip_addr_t;
250 #define IPADDR4_INIT(u32val)                    { u32val }
251 #define IPADDR4_INIT_BYTES(a,b,c,d)             IPADDR4_INIT(PP_HTONL(LWIP_MAKEU32(a,b,c,d)))
252 #define IP_IS_V4_VAL(ipaddr)                    1
253 #define IP_IS_V6_VAL(ipaddr)                    0
254 #define IP_IS_V4(ipaddr)                        1
255 #define IP_IS_V6(ipaddr)                        0
256 #define IP_IS_ANY_TYPE_VAL(ipaddr)              0
257 #define IP_SET_TYPE_VAL(ipaddr, iptype)
258 #define IP_SET_TYPE(ipaddr, iptype)
259 #define IP_GET_TYPE(ipaddr)                     IPADDR_TYPE_V4
260 #define ip_2_ip4(ipaddr)                        (ipaddr)
261 #define IP_ADDR4(ipaddr,a,b,c,d)                IP4_ADDR(ipaddr,a,b,c,d)
262 
263 #define ip_addr_copy(dest, src)                 ip4_addr_copy(dest, src)
264 #define ip_addr_copy_from_ip4(dest, src)        ip4_addr_copy(dest, src)
265 #define ip_addr_set_ip4_u32(ipaddr, val)        ip4_addr_set_u32(ip_2_ip4(ipaddr), val)
266 #define ip_addr_get_ip4_u32(ipaddr)             ip4_addr_get_u32(ip_2_ip4(ipaddr))
267 #define ip_addr_set(dest, src)                  ip4_addr_set(dest, src)
268 #define ip_addr_set_ipaddr(dest, src)           ip4_addr_set(dest, src)
269 #define ip_addr_set_zero(ipaddr)                ip4_addr_set_zero(ipaddr)
270 #define ip_addr_set_zero_ip4(ipaddr)            ip4_addr_set_zero(ipaddr)
271 #define ip_addr_set_any(is_ipv6, ipaddr)        ip4_addr_set_any(ipaddr)
272 #define ip_addr_set_loopback(is_ipv6, ipaddr)   ip4_addr_set_loopback(ipaddr)
273 #define ip_addr_set_hton(dest, src)             ip4_addr_set_hton(dest, src)
274 #define ip_addr_get_network(target, host, mask) ip4_addr_get_network(target, host, mask)
275 #define ip_addr_netcmp(addr1, addr2, mask)      ip4_addr_netcmp(addr1, addr2, mask)
276 #define ip_addr_cmp(addr1, addr2)               ip4_addr_cmp(addr1, addr2)
277 #define ip_addr_isany(ipaddr)                   ip4_addr_isany(ipaddr)
278 #define ip_addr_isany_val(ipaddr)               ip4_addr_isany_val(ipaddr)
279 #define ip_addr_isloopback(ipaddr)              ip4_addr_isloopback(ipaddr)
280 #define ip_addr_islinklocal(ipaddr)             ip4_addr_islinklocal(ipaddr)
281 #define ip_addr_isbroadcast(addr, netif)        ip4_addr_isbroadcast(addr, netif)
282 #define ip_addr_ismulticast(ipaddr)             ip4_addr_ismulticast(ipaddr)
283 #define ip_addr_debug_print(debug, ipaddr)      ip4_addr_debug_print(debug, ipaddr)
284 #define ip_addr_debug_print_val(debug, ipaddr)  ip4_addr_debug_print_val(debug, ipaddr)
285 #define ipaddr_ntoa(ipaddr)                     ip4addr_ntoa(ipaddr)
286 #define ipaddr_ntoa_r(ipaddr, buf, buflen)      ip4addr_ntoa_r(ipaddr, buf, buflen)
287 #define ipaddr_aton(cp, addr)                   ip4addr_aton(cp, addr)
288 
289 #define IPADDR_STRLEN_MAX   IP4ADDR_STRLEN_MAX
290 
291 #define IP46_ADDR_ANY(type) (IP4_ADDR_ANY)
292 
293 #else /* LWIP_IPV4 */
294 
295 typedef ip6_addr_t ip_addr_t;
296 #define IPADDR6_INIT(a, b, c, d)                { { a, b, c, d } IPADDR6_ZONE_INIT }
297 #define IPADDR6_INIT_HOST(a, b, c, d)           { { PP_HTONL(a), PP_HTONL(b), PP_HTONL(c), PP_HTONL(d) } IPADDR6_ZONE_INIT }
298 #define IP_IS_V4_VAL(ipaddr)                    0
299 #define IP_IS_V6_VAL(ipaddr)                    1
300 #define IP_IS_V4(ipaddr)                        0
301 #define IP_IS_V6(ipaddr)                        1
302 #define IP_IS_ANY_TYPE_VAL(ipaddr)              0
303 #define IP_SET_TYPE_VAL(ipaddr, iptype)
304 #define IP_SET_TYPE(ipaddr, iptype)
305 #define IP_GET_TYPE(ipaddr)                     IPADDR_TYPE_V6
306 #define ip_2_ip6(ipaddr)                        (ipaddr)
307 #define IP_ADDR6(ipaddr,i0,i1,i2,i3)            IP6_ADDR(ipaddr,i0,i1,i2,i3)
308 #define IP_ADDR6_HOST(ipaddr,i0,i1,i2,i3)       IP_ADDR6(ipaddr,PP_HTONL(i0),PP_HTONL(i1),PP_HTONL(i2),PP_HTONL(i3))
309 
310 #define ip_addr_copy(dest, src)                 ip6_addr_copy(dest, src)
311 #define ip_addr_copy_from_ip6(dest, src)        ip6_addr_copy(dest, src)
312 #define ip_addr_copy_from_ip6_packed(dest, src) ip6_addr_copy_from_packed(dest, src)
313 #define ip_addr_set(dest, src)                  ip6_addr_set(dest, src)
314 #define ip_addr_set_ipaddr(dest, src)           ip6_addr_set(dest, src)
315 #define ip_addr_set_zero(ipaddr)                ip6_addr_set_zero(ipaddr)
316 #define ip_addr_set_zero_ip6(ipaddr)            ip6_addr_set_zero(ipaddr)
317 #define ip_addr_set_any(is_ipv6, ipaddr)        ip6_addr_set_any(ipaddr)
318 #define ip_addr_set_loopback(is_ipv6, ipaddr)   ip6_addr_set_loopback(ipaddr)
319 #define ip_addr_set_hton(dest, src)             ip6_addr_set_hton(dest, src)
320 #define ip_addr_get_network(target, host, mask) ip6_addr_set_zero(target)
321 #define ip_addr_netcmp(addr1, addr2, mask)      0
322 #define ip_addr_cmp(addr1, addr2)               ip6_addr_cmp(addr1, addr2)
323 #define ip_addr_isany(ipaddr)                   ip6_addr_isany(ipaddr)
324 #define ip_addr_isany_val(ipaddr)               ip6_addr_isany_val(ipaddr)
325 #define ip_addr_isloopback(ipaddr)              ip6_addr_isloopback(ipaddr)
326 #define ip_addr_islinklocal(ipaddr)             ip6_addr_islinklocal(ipaddr)
327 #define ip_addr_isbroadcast(addr, netif)        0
328 #define ip_addr_ismulticast(ipaddr)             ip6_addr_ismulticast(ipaddr)
329 #define ip_addr_debug_print(debug, ipaddr)      ip6_addr_debug_print(debug, ipaddr)
330 #define ip_addr_debug_print_val(debug, ipaddr)  ip6_addr_debug_print_val(debug, ipaddr)
331 #define ipaddr_ntoa(ipaddr)                     ip6addr_ntoa(ipaddr)
332 #define ipaddr_ntoa_r(ipaddr, buf, buflen)      ip6addr_ntoa_r(ipaddr, buf, buflen)
333 #define ipaddr_aton(cp, addr)                   ip6addr_aton(cp, addr)
334 
335 #define IPADDR_STRLEN_MAX   IP6ADDR_STRLEN_MAX
336 
337 #define IP46_ADDR_ANY(type) (IP6_ADDR_ANY)
338 
339 #endif /* LWIP_IPV4 */
340 #endif /* LWIP_IPV4 && LWIP_IPV6 */
341 
342 #if LWIP_IPV4
343 
344 extern const ip_addr_t ip_addr_any;
345 extern const ip_addr_t ip_addr_broadcast;
346 
347 /**
348  * @ingroup ip4addr
349  * Can be used as a fixed/const ip_addr_t
350  * for the IP wildcard.
351  * Defined to @ref IP4_ADDR_ANY when IPv4 is enabled.
352  * Defined to @ref IP6_ADDR_ANY in IPv6 only systems.
353  * Use this if you can handle IPv4 _AND_ IPv6 addresses.
354  * Use @ref IP4_ADDR_ANY or @ref IP6_ADDR_ANY when the IP
355  * type matters.
356  */
357 #define IP_ADDR_ANY         IP4_ADDR_ANY
358 /**
359  * @ingroup ip4addr
360  * Can be used as a fixed/const ip_addr_t
361  * for the IPv4 wildcard and the broadcast address
362  */
363 #define IP4_ADDR_ANY        (&ip_addr_any)
364 /**
365  * @ingroup ip4addr
366  * Can be used as a fixed/const ip4_addr_t
367  * for the wildcard and the broadcast address
368  */
369 #define IP4_ADDR_ANY4       (ip_2_ip4(&ip_addr_any))
370 
371 /** @ingroup ip4addr */
372 #define IP_ADDR_BROADCAST   (&ip_addr_broadcast)
373 /** @ingroup ip4addr */
374 #define IP4_ADDR_BROADCAST  (ip_2_ip4(&ip_addr_broadcast))
375 
376 #endif /* LWIP_IPV4*/
377 
378 #if LWIP_IPV6
379 
380 extern const ip_addr_t ip6_addr_any;
381 
382 /**
383  * @ingroup ip6addr
384  * IP6_ADDR_ANY can be used as a fixed ip_addr_t
385  * for the IPv6 wildcard address
386  */
387 #define IP6_ADDR_ANY   (&ip6_addr_any)
388 /**
389  * @ingroup ip6addr
390  * IP6_ADDR_ANY6 can be used as a fixed ip6_addr_t
391  * for the IPv6 wildcard address
392  */
393 #define IP6_ADDR_ANY6  (ip_2_ip6(&ip6_addr_any))
394 
395 #if !LWIP_IPV4
396 /** IPv6-only configurations */
397 #define IP_ADDR_ANY IP6_ADDR_ANY
398 #endif /* !LWIP_IPV4 */
399 
400 #endif
401 
402 #if LWIP_IPV4 && LWIP_IPV6
403 /** @ingroup ipaddr */
404 #define IP_ANY_TYPE    (&ip_addr_any_type)
405 #else
406 #define IP_ANY_TYPE    IP_ADDR_ANY
407 #endif
408 
409 #ifdef __cplusplus
410 }
411 #endif
412 
413 #endif /* LWIP_HDR_IP_ADDR_H */
414