1 /**
2 * @file
3 *
4 * IPv6 version of ICMP, as per RFC 4443.
5 */
6
7 /*
8 * Copyright (c) 2010 Inico Technologies Ltd.
9 * All rights reserved.
10 *
11 * Redistribution and use in source and binary forms, with or without modification,
12 * are permitted provided that the following conditions are met:
13 *
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.
21 *
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
31 * OF SUCH DAMAGE.
32 *
33 * This file is part of the lwIP TCP/IP stack.
34 *
35 * Author: Ivan Delamer <delamer@inicotech.com>
36 *
37 *
38 * Please coordinate changes and requests with Ivan Delamer
39 * <delamer@inicotech.com>
40 */
41
42 #include "lwip/opt.h"
43
44 #if LWIP_ICMP6 && LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */
45
46 #include "lwip/icmp6.h"
47 #include "lwip/prot/icmp6.h"
48 #include "lwip/ip6.h"
49 #include "lwip/ip6_addr.h"
50 #include "lwip/inet_chksum.h"
51 #include "lwip/pbuf.h"
52 #include "lwip/netif.h"
53 #include "lwip/nd6.h"
54 #include "lwip/mld6.h"
55 #include "lwip/ip.h"
56 #include "lwip/stats.h"
57
58 #include <string.h>
59
60 #if !LWIP_ICMP6_DATASIZE || (LWIP_ICMP6_DATASIZE > (IP6_MIN_MTU_LENGTH - IP6_HLEN - ICMP6_HLEN))
61 #undef LWIP_ICMP6_DATASIZE
62 #define LWIP_ICMP6_DATASIZE (IP6_MIN_MTU_LENGTH - IP6_HLEN - ICMP6_HLEN)
63 #endif
64
65 /* Forward declarations */
66 static void icmp6_send_response(struct pbuf *p, u8_t code, u32_t data, u8_t type);
67 static void icmp6_send_response_with_addrs(struct pbuf *p, u8_t code, u32_t data,
68 u8_t type, const ip6_addr_t *src_addr, const ip6_addr_t *dest_addr);
69 static void icmp6_send_response_with_addrs_and_netif(struct pbuf *p, u8_t code, u32_t data,
70 u8_t type, const ip6_addr_t *src_addr, const ip6_addr_t *dest_addr, struct netif *netif);
71
72
73 /**
74 * Process an input ICMPv6 message. Called by ip6_input.
75 *
76 * Will generate a reply for echo requests. Other messages are forwarded
77 * to nd6_input, or mld6_input.
78 *
79 * @param p the mld packet, p->payload pointing to the icmpv6 header
80 * @param inp the netif on which this packet was received
81 */
82 void
icmp6_input(struct pbuf * p,struct netif * inp)83 icmp6_input(struct pbuf *p, struct netif *inp)
84 {
85 struct icmp6_hdr *icmp6hdr;
86 struct pbuf *r;
87 const ip6_addr_t *reply_src;
88
89 ICMP6_STATS_INC(icmp6.recv);
90
91 /* Check that ICMPv6 header fits in payload */
92 if (p->len < sizeof(struct icmp6_hdr)) {
93 /* drop short packets */
94 pbuf_free(p);
95 ICMP6_STATS_INC(icmp6.lenerr);
96 ICMP6_STATS_INC(icmp6.drop);
97 return;
98 }
99
100 icmp6hdr = (struct icmp6_hdr *)p->payload;
101
102 #if CHECKSUM_CHECK_ICMP6
103 IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_CHECK_ICMP6) {
104 if (ip6_chksum_pseudo(p, IP6_NEXTH_ICMP6, p->tot_len, ip6_current_src_addr(),
105 ip6_current_dest_addr()) != 0) {
106 /* Checksum failed */
107 pbuf_free(p);
108 ICMP6_STATS_INC(icmp6.chkerr);
109 ICMP6_STATS_INC(icmp6.drop);
110 return;
111 }
112 }
113 #endif /* CHECKSUM_CHECK_ICMP6 */
114
115 switch (icmp6hdr->type) {
116 case ICMP6_TYPE_NA: /* Neighbor advertisement */
117 case ICMP6_TYPE_NS: /* Neighbor solicitation */
118 case ICMP6_TYPE_RA: /* Router advertisement */
119 case ICMP6_TYPE_RD: /* Redirect */
120 case ICMP6_TYPE_PTB: /* Packet too big */
121 nd6_input(p, inp);
122 return;
123 case ICMP6_TYPE_RS:
124 #if LWIP_IPV6_FORWARD
125 /* @todo implement router functionality */
126 #endif
127 break;
128 #if LWIP_IPV6_MLD
129 case ICMP6_TYPE_MLQ:
130 case ICMP6_TYPE_MLR:
131 case ICMP6_TYPE_MLD:
132 mld6_input(p, inp);
133 return;
134 #endif
135 case ICMP6_TYPE_EREQ:
136 #if !LWIP_MULTICAST_PING
137 /* multicast destination address? */
138 if (ip6_addr_ismulticast(ip6_current_dest_addr())) {
139 /* drop */
140 pbuf_free(p);
141 ICMP6_STATS_INC(icmp6.drop);
142 return;
143 }
144 #endif /* LWIP_MULTICAST_PING */
145
146 /* Allocate reply. */
147 r = pbuf_alloc(PBUF_IP, p->tot_len, PBUF_RAM);
148 if (r == NULL) {
149 /* drop */
150 pbuf_free(p);
151 ICMP6_STATS_INC(icmp6.memerr);
152 return;
153 }
154
155 /* Copy echo request. */
156 if (pbuf_copy(r, p) != ERR_OK) {
157 /* drop */
158 pbuf_free(p);
159 pbuf_free(r);
160 ICMP6_STATS_INC(icmp6.err);
161 return;
162 }
163
164 /* Determine reply source IPv6 address. */
165 #if LWIP_MULTICAST_PING
166 if (ip6_addr_ismulticast(ip6_current_dest_addr())) {
167 reply_src = ip_2_ip6(ip6_select_source_address(inp, ip6_current_src_addr()));
168 if (reply_src == NULL) {
169 /* drop */
170 pbuf_free(p);
171 pbuf_free(r);
172 ICMP6_STATS_INC(icmp6.rterr);
173 return;
174 }
175 }
176 else
177 #endif /* LWIP_MULTICAST_PING */
178 {
179 reply_src = ip6_current_dest_addr();
180 }
181
182 /* Set fields in reply. */
183 ((struct icmp6_echo_hdr *)(r->payload))->type = ICMP6_TYPE_EREP;
184 ((struct icmp6_echo_hdr *)(r->payload))->chksum = 0;
185 #if CHECKSUM_GEN_ICMP6
186 IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_GEN_ICMP6) {
187 ((struct icmp6_echo_hdr *)(r->payload))->chksum = ip6_chksum_pseudo(r,
188 IP6_NEXTH_ICMP6, r->tot_len, reply_src, ip6_current_src_addr());
189 }
190 #endif /* CHECKSUM_GEN_ICMP6 */
191
192 /* Send reply. */
193 ICMP6_STATS_INC(icmp6.xmit);
194 ip6_output_if(r, reply_src, ip6_current_src_addr(),
195 LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, inp);
196 pbuf_free(r);
197
198 break;
199 default:
200 ICMP6_STATS_INC(icmp6.proterr);
201 ICMP6_STATS_INC(icmp6.drop);
202 break;
203 }
204
205 pbuf_free(p);
206 }
207
208
209 /**
210 * Send an icmpv6 'destination unreachable' packet.
211 *
212 * This function must be used only in direct response to a packet that is being
213 * received right now. Otherwise, address zones would be lost.
214 *
215 * @param p the input packet for which the 'unreachable' should be sent,
216 * p->payload pointing to the IPv6 header
217 * @param c ICMPv6 code for the unreachable type
218 */
219 void
icmp6_dest_unreach(struct pbuf * p,enum icmp6_dur_code c)220 icmp6_dest_unreach(struct pbuf *p, enum icmp6_dur_code c)
221 {
222 icmp6_send_response(p, c, 0, ICMP6_TYPE_DUR);
223 }
224
225 /**
226 * Send an icmpv6 'packet too big' packet.
227 *
228 * This function must be used only in direct response to a packet that is being
229 * received right now. Otherwise, address zones would be lost.
230 *
231 * @param p the input packet for which the 'packet too big' should be sent,
232 * p->payload pointing to the IPv6 header
233 * @param mtu the maximum mtu that we can accept
234 */
235 void
icmp6_packet_too_big(struct pbuf * p,u32_t mtu)236 icmp6_packet_too_big(struct pbuf *p, u32_t mtu)
237 {
238 icmp6_send_response(p, 0, mtu, ICMP6_TYPE_PTB);
239 }
240
241 /**
242 * Send an icmpv6 'time exceeded' packet.
243 *
244 * This function must be used only in direct response to a packet that is being
245 * received right now. Otherwise, address zones would be lost.
246 *
247 * @param p the input packet for which the 'time exceeded' should be sent,
248 * p->payload pointing to the IPv6 header
249 * @param c ICMPv6 code for the time exceeded type
250 */
251 void
icmp6_time_exceeded(struct pbuf * p,enum icmp6_te_code c)252 icmp6_time_exceeded(struct pbuf *p, enum icmp6_te_code c)
253 {
254 icmp6_send_response(p, c, 0, ICMP6_TYPE_TE);
255 }
256
257 /**
258 * Send an icmpv6 'time exceeded' packet, with explicit source and destination
259 * addresses.
260 *
261 * This function may be used to send a response sometime after receiving the
262 * packet for which this response is meant. The provided source and destination
263 * addresses are used primarily to retain their zone information.
264 *
265 * @param p the input packet for which the 'time exceeded' should be sent,
266 * p->payload pointing to the IPv6 header
267 * @param c ICMPv6 code for the time exceeded type
268 * @param src_addr source address of the original packet, with zone information
269 * @param dest_addr destination address of the original packet, with zone
270 * information
271 */
272 void
icmp6_time_exceeded_with_addrs(struct pbuf * p,enum icmp6_te_code c,const ip6_addr_t * src_addr,const ip6_addr_t * dest_addr)273 icmp6_time_exceeded_with_addrs(struct pbuf *p, enum icmp6_te_code c,
274 const ip6_addr_t *src_addr, const ip6_addr_t *dest_addr)
275 {
276 icmp6_send_response_with_addrs(p, c, 0, ICMP6_TYPE_TE, src_addr, dest_addr);
277 }
278
279 /**
280 * Send an icmpv6 'parameter problem' packet.
281 *
282 * This function must be used only in direct response to a packet that is being
283 * received right now. Otherwise, address zones would be lost and the calculated
284 * offset would be wrong (calculated against ip6_current_header()).
285 *
286 * @param p the input packet for which the 'param problem' should be sent,
287 * p->payload pointing to the IP header
288 * @param c ICMPv6 code for the param problem type
289 * @param pointer the pointer to the byte where the parameter is found
290 */
291 void
icmp6_param_problem(struct pbuf * p,enum icmp6_pp_code c,const void * pointer)292 icmp6_param_problem(struct pbuf *p, enum icmp6_pp_code c, const void *pointer)
293 {
294 u32_t pointer_u32 = (u32_t)((const u8_t *)pointer - (const u8_t *)ip6_current_header());
295 icmp6_send_response(p, c, pointer_u32, ICMP6_TYPE_PP);
296 }
297
298 /**
299 * Send an ICMPv6 packet in response to an incoming packet.
300 * The packet is sent *to* ip_current_src_addr() on ip_current_netif().
301 *
302 * @param p the input packet for which the response should be sent,
303 * p->payload pointing to the IPv6 header
304 * @param code Code of the ICMPv6 header
305 * @param data Additional 32-bit parameter in the ICMPv6 header
306 * @param type Type of the ICMPv6 header
307 */
308 static void
icmp6_send_response(struct pbuf * p,u8_t code,u32_t data,u8_t type)309 icmp6_send_response(struct pbuf *p, u8_t code, u32_t data, u8_t type)
310 {
311 const struct ip6_addr *reply_src, *reply_dest;
312 struct netif *netif = ip_current_netif();
313
314 LWIP_ASSERT("icmpv6 packet not a direct response", netif != NULL);
315 reply_dest = ip6_current_src_addr();
316
317 /* Select an address to use as source. */
318 reply_src = ip_2_ip6(ip6_select_source_address(netif, reply_dest));
319 if (reply_src == NULL) {
320 ICMP6_STATS_INC(icmp6.rterr);
321 return;
322 }
323 icmp6_send_response_with_addrs_and_netif(p, code, data, type, reply_src, reply_dest, netif);
324 }
325
326 /**
327 * Send an ICMPv6 packet in response to an incoming packet.
328 *
329 * Call this function if the packet is NOT sent as a direct response to an
330 * incoming packet, but rather sometime later (e.g. for a fragment reassembly
331 * timeout). The caller must provide the zoned source and destination addresses
332 * from the original packet with the src_addr and dest_addr parameters. The
333 * reason for this approach is that while the addresses themselves are part of
334 * the original packet, their zone information is not, thus possibly resulting
335 * in a link-local response being sent over the wrong link.
336 *
337 * @param p the input packet for which the response should be sent,
338 * p->payload pointing to the IPv6 header
339 * @param code Code of the ICMPv6 header
340 * @param data Additional 32-bit parameter in the ICMPv6 header
341 * @param type Type of the ICMPv6 header
342 * @param src_addr original source address
343 * @param dest_addr original destination address
344 */
345 static void
icmp6_send_response_with_addrs(struct pbuf * p,u8_t code,u32_t data,u8_t type,const ip6_addr_t * src_addr,const ip6_addr_t * dest_addr)346 icmp6_send_response_with_addrs(struct pbuf *p, u8_t code, u32_t data, u8_t type,
347 const ip6_addr_t *src_addr, const ip6_addr_t *dest_addr)
348 {
349 const struct ip6_addr *reply_src, *reply_dest;
350 struct netif *netif;
351
352 /* Get the destination address and netif for this ICMP message. */
353 LWIP_ASSERT("must provide both source and destination", src_addr != NULL);
354 LWIP_ASSERT("must provide both source and destination", dest_addr != NULL);
355
356 /* Special case, as ip6_current_xxx is either NULL, or points
357 to a different packet than the one that expired. */
358 IP6_ADDR_ZONECHECK(src_addr);
359 IP6_ADDR_ZONECHECK(dest_addr);
360 /* Swap source and destination for the reply. */
361 reply_dest = src_addr;
362 reply_src = dest_addr;
363 #ifdef LOSCFG_NET_CONTAINER
364 netif = ip6_route(reply_src, reply_dest, get_root_net_group());
365 #else
366 netif = ip6_route(reply_src, reply_dest);
367 #endif
368 if (netif == NULL) {
369 ICMP6_STATS_INC(icmp6.rterr);
370 return;
371 }
372 icmp6_send_response_with_addrs_and_netif(p, code, data, type, reply_src,
373 reply_dest, netif);
374 }
375
376 /**
377 * Send an ICMPv6 packet (with srd/dst address and netif given).
378 *
379 * @param p the input packet for which the response should be sent,
380 * p->payload pointing to the IPv6 header
381 * @param code Code of the ICMPv6 header
382 * @param data Additional 32-bit parameter in the ICMPv6 header
383 * @param type Type of the ICMPv6 header
384 * @param reply_src source address of the packet to send
385 * @param reply_dest destination address of the packet to send
386 * @param netif netif to send the packet
387 */
388 static void
icmp6_send_response_with_addrs_and_netif(struct pbuf * p,u8_t code,u32_t data,u8_t type,const ip6_addr_t * reply_src,const ip6_addr_t * reply_dest,struct netif * netif)389 icmp6_send_response_with_addrs_and_netif(struct pbuf *p, u8_t code, u32_t data, u8_t type,
390 const ip6_addr_t *reply_src, const ip6_addr_t *reply_dest, struct netif *netif)
391 {
392 struct pbuf *q;
393 struct icmp6_hdr *icmp6hdr;
394 u16_t datalen = LWIP_MIN(p->tot_len, LWIP_ICMP6_DATASIZE);
395 u16_t offset;
396
397 /* ICMPv6 header + datalen (as much of the offending packet as possible) */
398 q = pbuf_alloc(PBUF_IP, sizeof(struct icmp6_hdr) + datalen,
399 PBUF_RAM);
400 if (q == NULL) {
401 LWIP_DEBUGF(ICMP_DEBUG, ("icmp_time_exceeded: failed to allocate pbuf for ICMPv6 packet.\n"));
402 ICMP6_STATS_INC(icmp6.memerr);
403 return;
404 }
405 LWIP_ASSERT("check that first pbuf can hold icmp6 header",
406 (q->len >= (sizeof(struct icmp6_hdr))));
407
408 icmp6hdr = (struct icmp6_hdr *)q->payload;
409 icmp6hdr->type = type;
410 icmp6hdr->code = code;
411 icmp6hdr->data = lwip_htonl(data);
412
413 /* copy fields from original packet (which may be a chain of pbufs) */
414 offset = sizeof(struct icmp6_hdr);
415 while (p && datalen) {
416 u16_t len = LWIP_MIN(datalen, p->len);
417 err_t res = pbuf_take_at(q, p->payload, len, offset);
418 if (res != ERR_OK) break;
419 datalen -= len;
420 offset += len;
421 p = p->next;
422 }
423
424 /* calculate checksum */
425 icmp6hdr->chksum = 0;
426 #if CHECKSUM_GEN_ICMP6
427 IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_ICMP6) {
428 icmp6hdr->chksum = ip6_chksum_pseudo(q, IP6_NEXTH_ICMP6, q->tot_len,
429 reply_src, reply_dest);
430 }
431 #endif /* CHECKSUM_GEN_ICMP6 */
432
433 ICMP6_STATS_INC(icmp6.xmit);
434 ip6_output_if(q, reply_src, reply_dest, LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, netif);
435 pbuf_free(q);
436 }
437
438 #endif /* LWIP_ICMP6 && LWIP_IPV6 */
439