8 * Copyright (c) 2010 Inico Technologies Ltd.
11 * Redistribution and use in source and binary forms, with or without modification,
12 * are permitted provided that the following conditions are met:
14 * 1. Redistributions of source code must retain the above copyright notice,
15 * this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright notice,
17 * this list of conditions and the following disclaimer in the documentation
18 * and/or other materials provided with the distribution.
19 * 3. The name of the author may not be used to endorse or promote products
20 * derived from this software without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
23 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
24 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
25 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
26 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
27 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
30 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
33 * This file is part of the lwIP TCP/IP stack.
35 * Author: Ivan Delamer <delamer@inicotech.com>
37 * Structs and macros for handling IPv6 addresses.
39 * Please coordinate changes and requests with Ivan Delamer
40 * <delamer@inicotech.com>
42 #ifndef __LWIP_IP6_ADDR_H__
43 #define __LWIP_IP6_ADDR_H__
47 #if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */
55 /* This is the aligned version of ip6_addr_t,
56 used as local variable, on the stack, etc. */
61 /* This is the packed version of ip6_addr_t,
62 used in network headers that are itself packed */
63 #ifdef PACK_STRUCT_USE_INCLUDES
64 # include "arch/bpstruct.h"
67 struct ip6_addr_packed {
68 PACK_STRUCT_FIELD(u32_t addr[4]);
71 #ifdef PACK_STRUCT_USE_INCLUDES
72 # include "arch/epstruct.h"
75 /** ip6_addr_t uses a struct for convenience only, so that the same defines can
76 * operate both on ip6_addr_t as well as on ip6_addr_p_t. */
77 typedef struct ip6_addr ip6_addr_t;
78 typedef struct ip6_addr_packed ip6_addr_p_t;
81 /** IP6_ADDR_ANY can be used as a fixed IPv6 address
84 extern const ip6_addr_t ip6_addr_any;
85 #define IP6_ADDR_ANY ((ip6_addr_t *)&ip6_addr_any)
90 #if BYTE_ORDER == BIG_ENDIAN
91 /** Set an IPv6 partial address given by byte-parts. */
92 #define IP6_ADDR(ip6addr, index, a,b,c,d) \
93 (ip6addr)->addr[index] = ((u32_t)((a) & 0xff) << 24) | \
94 ((u32_t)((b) & 0xff) << 16) | \
95 ((u32_t)((c) & 0xff) << 8) | \
98 /** Set an IPv6 partial address given by byte-parts.
99 Little-endian version, stored in network order (no htonl). */
100 #define IP6_ADDR(ip6addr, index, a,b,c,d) \
101 (ip6addr)->addr[index] = ((u32_t)((d) & 0xff) << 24) | \
102 ((u32_t)((c) & 0xff) << 16) | \
103 ((u32_t)((b) & 0xff) << 8) | \
107 /** Access address in 16-bit block */
108 #define IP6_ADDR_BLOCK1(ip6addr) ((u16_t)(htonl((ip6addr)->addr[0]) >> 16) & 0xffff)
109 #define IP6_ADDR_BLOCK2(ip6addr) ((u16_t)(htonl((ip6addr)->addr[0])) & 0xffff)
110 #define IP6_ADDR_BLOCK3(ip6addr) ((u16_t)(htonl((ip6addr)->addr[1]) >> 16) & 0xffff)
111 #define IP6_ADDR_BLOCK4(ip6addr) ((u16_t)(htonl((ip6addr)->addr[1])) & 0xffff)
112 #define IP6_ADDR_BLOCK5(ip6addr) ((u16_t)(htonl((ip6addr)->addr[2]) >> 16) & 0xffff)
113 #define IP6_ADDR_BLOCK6(ip6addr) ((u16_t)(htonl((ip6addr)->addr[2])) & 0xffff)
114 #define IP6_ADDR_BLOCK7(ip6addr) ((u16_t)(htonl((ip6addr)->addr[3]) >> 16) & 0xffff)
115 #define IP6_ADDR_BLOCK8(ip6addr) ((u16_t)(htonl((ip6addr)->addr[3])) & 0xffff)
117 /** Copy IPv6 address - faster than ip6_addr_set: no NULL check */
118 #define ip6_addr_copy(dest, src) do{(dest).addr[0] = (src).addr[0]; \
119 (dest).addr[1] = (src).addr[1]; \
120 (dest).addr[2] = (src).addr[2]; \
121 (dest).addr[3] = (src).addr[3];}while(0)
122 /** Safely copy one IPv6 address to another (src may be NULL) */
123 #define ip6_addr_set(dest, src) do{(dest)->addr[0] = (src) == NULL ? 0 : (src)->addr[0]; \
124 (dest)->addr[1] = (src) == NULL ? 0 : (src)->addr[1]; \
125 (dest)->addr[2] = (src) == NULL ? 0 : (src)->addr[2]; \
126 (dest)->addr[3] = (src) == NULL ? 0 : (src)->addr[3];}while(0)
128 /** Set complete address to zero */
129 #define ip6_addr_set_zero(ip6addr) do{(ip6addr)->addr[0] = 0; \
130 (ip6addr)->addr[1] = 0; \
131 (ip6addr)->addr[2] = 0; \
132 (ip6addr)->addr[3] = 0;}while(0)
134 /** Set address to ipv6 'any' (no need for htonl()) */
135 #define ip6_addr_set_any(ip6addr) ip6_addr_set_zero(ip6addr)
136 /** Set address to ipv6 loopback address */
137 #define ip6_addr_set_loopback(ip6addr) do{(ip6addr)->addr[0] = 0; \
138 (ip6addr)->addr[1] = 0; \
139 (ip6addr)->addr[2] = 0; \
140 (ip6addr)->addr[3] = PP_HTONL(0x00000001UL);}while(0)
141 /** Safely copy one IPv6 address to another and change byte order
142 * from host- to network-order. */
143 #define ip6_addr_set_hton(dest, src) do{(dest)->addr[0] = (src) == NULL ? 0 : htonl((src)->addr[0]); \
144 (dest)->addr[1] = (src) == NULL ? 0 : htonl((src)->addr[1]); \
145 (dest)->addr[2] = (src) == NULL ? 0 : htonl((src)->addr[2]); \
146 (dest)->addr[3] = (src) == NULL ? 0 : htonl((src)->addr[3]);}while(0)
151 * Determine if two IPv6 address are on the same network.
153 * @arg addr1 IPv6 address 1
154 * @arg addr2 IPv6 address 2
155 * @return !0 if the network identifiers of both address match
157 #define ip6_addr_netcmp(addr1, addr2) (((addr1)->addr[0] == (addr2)->addr[0]) && \
158 ((addr1)->addr[1] == (addr2)->addr[1]))
160 #define ip6_addr_cmp(addr1, addr2) (((addr1)->addr[0] == (addr2)->addr[0]) && \
161 ((addr1)->addr[1] == (addr2)->addr[1]) && \
162 ((addr1)->addr[2] == (addr2)->addr[2]) && \
163 ((addr1)->addr[3] == (addr2)->addr[3]))
165 #define ip6_get_subnet_id(ip6addr) (htonl((ip6addr)->addr[2]) & 0x0000ffffUL)
167 #define ip6_addr_isany(ip6addr) (((ip6addr) == NULL) || \
168 (((ip6addr)->addr[0] == 0) && \
169 ((ip6addr)->addr[1] == 0) && \
170 ((ip6addr)->addr[2] == 0) && \
171 ((ip6addr)->addr[3] == 0)))
174 #define ip6_addr_isglobal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xe0000000UL)) == PP_HTONL(0x20000000UL))
176 #define ip6_addr_islinklocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffc00000UL)) == PP_HTONL(0xfe800000UL))
178 #define ip6_addr_issitelocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffc00000UL)) == PP_HTONL(0xfec00000UL))
180 #define ip6_addr_isuniquelocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xfe000000UL)) == PP_HTONL(0xfc000000UL))
182 #define ip6_addr_ismulticast(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff000000UL)) == PP_HTONL(0xff000000UL))
183 #define ip6_addr_multicast_transient_flag(ip6addr) ((ip6addr)->addr[0] & PP_HTONL(0x00100000UL))
184 #define ip6_addr_multicast_prefix_flag(ip6addr) ((ip6addr)->addr[0] & PP_HTONL(0x00200000UL))
185 #define ip6_addr_multicast_rendezvous_flag(ip6addr) ((ip6addr)->addr[0] & PP_HTONL(0x00400000UL))
186 #define ip6_addr_multicast_scope(ip6addr) ((htonl((ip6addr)->addr[0]) >> 16) & 0xf)
187 #define IP6_MULTICAST_SCOPE_RESERVED 0x0
188 #define IP6_MULTICAST_SCOPE_RESERVED0 0x0
189 #define IP6_MULTICAST_SCOPE_INTERFACE_LOCAL 0x1
190 #define IP6_MULTICAST_SCOPE_LINK_LOCAL 0x2
191 #define IP6_MULTICAST_SCOPE_RESERVED3 0x3
192 #define IP6_MULTICAST_SCOPE_ADMIN_LOCAL 0x4
193 #define IP6_MULTICAST_SCOPE_SITE_LOCAL 0x5
194 #define IP6_MULTICAST_SCOPE_ORGANIZATION_LOCAL 0x8
195 #define IP6_MULTICAST_SCOPE_GLOBAL 0xe
196 #define IP6_MULTICAST_SCOPE_RESERVEDF 0xf
197 #define ip6_addr_ismulticast_iflocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xff010000UL))
198 #define ip6_addr_ismulticast_linklocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xff020000UL))
199 #define ip6_addr_ismulticast_adminlocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xff040000UL))
200 #define ip6_addr_ismulticast_sitelocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xff050000UL))
201 #define ip6_addr_ismulticast_orglocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xff080000UL))
202 #define ip6_addr_ismulticast_global(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xff0e0000UL))
204 /* TODO define get/set for well-know multicast addresses, e.g. ff02::1 */
205 #define ip6_addr_isallnodes_iflocal(ip6addr) (((ip6addr)->addr[0] == PP_HTONL(0xff010000UL)) && \
206 ((ip6addr)->addr[1] == 0UL) && \
207 ((ip6addr)->addr[2] == 0UL) && \
208 ((ip6addr)->addr[3] == PP_HTONL(0x00000001UL)))
210 #define ip6_addr_isallnodes_linklocal(ip6addr) (((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \
211 ((ip6addr)->addr[1] == 0UL) && \
212 ((ip6addr)->addr[2] == 0UL) && \
213 ((ip6addr)->addr[3] == PP_HTONL(0x00000001UL)))
214 #define ip6_addr_set_allnodes_linklocal(ip6addr) do{(ip6addr)->addr[0] = PP_HTONL(0xff020000UL); \
215 (ip6addr)->addr[1] = 0; \
216 (ip6addr)->addr[2] = 0; \
217 (ip6addr)->addr[3] = PP_HTONL(0x00000001UL);}while(0)
219 #define ip6_addr_isallrouters_linklocal(ip6addr) (((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \
220 ((ip6addr)->addr[1] == 0UL) && \
221 ((ip6addr)->addr[2] == 0UL) && \
222 ((ip6addr)->addr[3] == PP_HTONL(0x00000002UL)))
223 #define ip6_addr_set_allrouters_linklocal(ip6addr) do{(ip6addr)->addr[0] = PP_HTONL(0xff020000UL); \
224 (ip6addr)->addr[1] = 0; \
225 (ip6addr)->addr[2] = 0; \
226 (ip6addr)->addr[3] = PP_HTONL(0x00000002UL);}while(0)
228 #define ip6_addr_issolicitednode(ip6addr) ( ((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \
229 ((ip6addr)->addr[2] == PP_HTONL(0x00000001UL)) && \
230 (((ip6addr)->addr[3] & PP_HTONL(0xff000000UL)) == PP_HTONL(0xff000000UL)) )
232 #define ip6_addr_set_solicitednode(ip6addr, if_id) do{(ip6addr)->addr[0] = PP_HTONL(0xff020000UL); \
233 (ip6addr)->addr[1] = 0; \
234 (ip6addr)->addr[2] = PP_HTONL(0x00000001UL); \
235 (ip6addr)->addr[3] = htonl(0xff000000UL | (htonl(if_id) & 0x00ffffffUL));}while(0)
238 /* IPv6 address states. */
239 #define IP6_ADDR_INVALID 0x00
240 #define IP6_ADDR_TENTATIVE 0x08
241 #define IP6_ADDR_TENTATIVE_1 0x09 /* 1 probe sent */
242 #define IP6_ADDR_TENTATIVE_2 0x0a /* 2 probes sent */
243 #define IP6_ADDR_TENTATIVE_3 0x0b /* 3 probes sent */
244 #define IP6_ADDR_TENTATIVE_4 0x0c /* 4 probes sent */
245 #define IP6_ADDR_TENTATIVE_5 0x0d /* 5 probes sent */
246 #define IP6_ADDR_TENTATIVE_6 0x0e /* 6 probes sent */
247 #define IP6_ADDR_TENTATIVE_7 0x0f /* 7 probes sent */
248 #define IP6_ADDR_VALID 0x10
249 #define IP6_ADDR_PREFERRED 0x30
250 #define IP6_ADDR_DEPRECATED 0x50
252 #define ip6_addr_isinvalid(addr_state) (addr_state == IP6_ADDR_INVALID)
253 #define ip6_addr_istentative(addr_state) (addr_state & IP6_ADDR_TENTATIVE)
254 #define ip6_addr_isvalid(addr_state) (addr_state & IP6_ADDR_VALID) /* Include valid, preferred, and deprecated. */
255 #define ip6_addr_ispreferred(addr_state) (addr_state == IP6_ADDR_PREFERRED)
256 #define ip6_addr_isdeprecated(addr_state) (addr_state == IP6_ADDR_DEPRECATED)
258 #define ip6_addr_debug_print(debug, ipaddr) \
259 LWIP_DEBUGF(debug, ("%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F, \
260 ipaddr != NULL ? IP6_ADDR_BLOCK1(ipaddr) : 0, \
261 ipaddr != NULL ? IP6_ADDR_BLOCK2(ipaddr) : 0, \
262 ipaddr != NULL ? IP6_ADDR_BLOCK3(ipaddr) : 0, \
263 ipaddr != NULL ? IP6_ADDR_BLOCK4(ipaddr) : 0, \
264 ipaddr != NULL ? IP6_ADDR_BLOCK5(ipaddr) : 0, \
265 ipaddr != NULL ? IP6_ADDR_BLOCK6(ipaddr) : 0, \
266 ipaddr != NULL ? IP6_ADDR_BLOCK7(ipaddr) : 0, \
267 ipaddr != NULL ? IP6_ADDR_BLOCK8(ipaddr) : 0))
269 int ip6addr_aton(const char *cp, ip6_addr_t *addr);
270 /** returns ptr to static buffer; not reentrant! */
271 char *ip6addr_ntoa(const ip6_addr_t *addr);
272 char *ip6addr_ntoa_r(const ip6_addr_t *addr, char *buf, int buflen);
280 #endif /* LWIP_IPV6 */
282 #endif /* __LWIP_IP6_ADDR_H__ */