2 * Copyright (c) 2016 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 #include <vnet/ip/ping.h>
17 #include <vnet/fib/ip6_fib.h>
18 #include <vnet/fib/ip4_fib.h>
19 #include <vnet/fib/fib_entry.h>
23 * @brief IPv4 and IPv6 ICMP Ping.
25 * This file contains code to suppport IPv4 or IPv6 ICMP ECHO_REQUEST to
32 format_icmp4_input_trace (u8 * s, va_list * va)
34 CLIB_UNUSED (vlib_main_t * vm) = va_arg (*va, vlib_main_t *);
35 CLIB_UNUSED (vlib_node_t * node) = va_arg (*va, vlib_node_t *);
36 icmp4_input_trace_t *t = va_arg (*va, icmp4_input_trace_t *);
39 format_ip4_header, t->packet_data, sizeof (t->packet_data));
45 * If we can find the ping run by an ICMP ID, then we send the signal
46 * to the CLI process referenced by that ping run, alongside with
47 * a freshly made copy of the packet.
48 * I opted for a packet copy to keep the main packet processing path
49 * the same as for all the other nodes.
54 signal_ip46_icmp_reply_event (vlib_main_t * vm,
55 u8 event_type, vlib_buffer_t * b0)
57 ping_main_t *pm = &ping_main;
63 case PING_RESPONSE_IP4:
65 icmp4_echo_request_header_t *h0 = vlib_buffer_get_current (b0);
66 net_icmp_id = h0->icmp_echo.id;
69 case PING_RESPONSE_IP6:
71 icmp6_echo_request_header_t *h0 = vlib_buffer_get_current (b0);
72 net_icmp_id = h0->icmp_echo.id;
79 uword *p = hash_get (pm->ping_run_by_icmp_id,
80 clib_net_to_host_u16 (net_icmp_id));
84 ping_run_t *pr = vec_elt_at_index (pm->ping_runs, p[0]);
85 if (vlib_buffer_alloc (vm, &bi0_copy, 1) == 1)
87 void *dst = vlib_buffer_get_current (vlib_get_buffer (vm, bi0_copy));
88 clib_memcpy (dst, vlib_buffer_get_current (b0), b0->current_length);
90 /* If buffer_alloc failed, bi0_copy == 0 - just signaling an event. */
92 vlib_process_signal_event (vm, pr->cli_process_id, event_type, bi0_copy);
96 * Process ICMPv6 echo replies
99 ip6_icmp_echo_reply_node_fn (vlib_main_t * vm,
100 vlib_node_runtime_t * node, vlib_frame_t * frame)
102 u32 n_left_from, *from;
104 from = vlib_frame_vector_args (frame); /* array of buffer indices */
105 n_left_from = frame->n_vectors; /* number of buffer indices */
107 while (n_left_from > 0)
114 b0 = vlib_get_buffer (vm, bi0);
116 signal_ip46_icmp_reply_event (vm, PING_RESPONSE_IP6, b0);
118 /* push this pkt to the next graph node, always error-drop */
119 next0 = ICMP6_ECHO_REPLY_NEXT_NORMAL;
120 vlib_set_next_frame_buffer (vm, node, next0, bi0);
126 return frame->n_vectors;
130 VLIB_REGISTER_NODE (ip6_icmp_echo_reply_node, static) =
132 .function = ip6_icmp_echo_reply_node_fn,
133 .name = "ip6-icmp-echo-reply",
134 .vector_size = sizeof (u32),
135 .format_trace = format_icmp6_input_trace,
136 .n_next_nodes = ICMP6_ECHO_REPLY_N_NEXT,
138 [ICMP6_ECHO_REPLY_NEXT_NORMAL] = "error-drop",
144 * Process ICMPv4 echo replies
147 ip4_icmp_echo_reply_node_fn (vlib_main_t * vm,
148 vlib_node_runtime_t * node, vlib_frame_t * frame)
150 u32 n_left_from, *from;
152 from = vlib_frame_vector_args (frame); /* array of buffer indices */
153 n_left_from = frame->n_vectors; /* number of buffer indices */
155 while (n_left_from > 0)
162 b0 = vlib_get_buffer (vm, bi0);
164 /* push this pkt to the next graph node, always error-drop */
165 signal_ip46_icmp_reply_event (vm, PING_RESPONSE_IP4, b0);
167 next0 = ICMP4_ECHO_REPLY_NEXT_NORMAL;
168 vlib_set_next_frame_buffer (vm, node, next0, bi0);
174 return frame->n_vectors;
178 VLIB_REGISTER_NODE (ip4_icmp_echo_reply_node, static) =
180 .function = ip4_icmp_echo_reply_node_fn,
181 .name = "ip4-icmp-echo-reply",
182 .vector_size = sizeof (u32),
183 .format_trace = format_icmp4_input_trace,
184 .n_next_nodes = ICMP4_ECHO_REPLY_N_NEXT,
186 [ICMP4_ECHO_REPLY_NEXT_NORMAL] = "error-drop",
191 char *ip6_lookup_next_nodes[] = IP6_LOOKUP_NEXT_NODES;
192 char *ip4_lookup_next_nodes[] = IP4_LOOKUP_NEXT_NODES;
194 /* get first interface address */
195 static ip6_address_t *
196 ip6_interface_first_address (ip6_main_t * im, u32 sw_if_index)
198 ip_lookup_main_t *lm = &im->lookup_main;
199 ip_interface_address_t *ia = 0;
200 ip6_address_t *result = 0;
202 foreach_ip_interface_address (lm, ia, sw_if_index,
203 1 /* honor unnumbered */ ,
207 ip_interface_address_get_address (lm, ia);
215 /* Fill in the ICMP ECHO structure, return the safety-checked and possibly shrunk data_len */
217 init_icmp46_echo_request (icmp46_echo_request_t * icmp46_echo,
218 u16 seq_host, u16 id_host, u16 data_len)
221 icmp46_echo->seq = clib_host_to_net_u16 (seq_host);
222 icmp46_echo->id = clib_host_to_net_u16 (id_host);
224 for (i = 0; i < sizeof (icmp46_echo->data); i++)
226 icmp46_echo->data[i] = i % 256;
229 if (data_len > sizeof (icmp46_echo_request_t))
231 data_len = sizeof (icmp46_echo_request_t);
237 * Given adj index, return sw_if_index, possibly overwritten
238 * by a parameter. There is mostly debug outputs here,
239 * but it turned out handy to have these.
243 adj_index_to_sw_if_index (vlib_main_t * vm, ip_lookup_main_t * lm,
244 char *lookup_next_nodes[], u32 adj_index0,
245 u32 sw_if_index, u8 verbose)
247 ip_adjacency_t *adj0 = ip_get_adjacency (lm, adj_index0);
248 u32 sw_if_index0 = adj0->rewrite_header.sw_if_index;
251 vlib_cli_output (vm, "Adjacency index: %u, sw_if_index: %u\n",
252 adj_index0, sw_if_index0);
253 vlib_cli_output (vm, "Adj: %s\n",
254 lookup_next_nodes[adj0->lookup_next_index]);
255 vlib_cli_output (vm, "Adj Interface: %d\n", adj0->if_address_index);
258 if (~0 != sw_if_index)
260 sw_if_index0 = sw_if_index;
263 vlib_cli_output (vm, "Forced set interface: %d\n", sw_if_index0);
269 static send_ip46_ping_result_t
270 send_ip6_ping (vlib_main_t * vm, ip6_main_t * im, ip6_address_t * pa6,
271 u32 sw_if_index, u16 seq_host, u16 id_host, u16 data_len,
274 icmp6_echo_request_header_t *h0;
277 ip_lookup_main_t *lm = &im->lookup_main;
278 int bogus_length = 0;
285 if (vlib_buffer_alloc (vm, &bi0, 1) != 1)
286 return SEND_PING_ALLOC_FAIL;
288 p0 = vlib_get_buffer (vm, bi0);
290 /* Determine sw_if_index0 of source intf, may be force-set via sw_if_index. */
291 vnet_buffer (p0)->sw_if_index[VLIB_RX] = 0;
292 vnet_buffer (p0)->sw_if_index[VLIB_TX] = ~0; /* use interface VRF */
294 adj_index0 = fib_entry_get_adj(ip6_fib_table_lookup(fib_index0, pa6, 128));
296 if (ADJ_INDEX_INVALID == adj_index0)
298 vlib_buffer_free (vm, &bi0, 1);
299 return SEND_PING_NO_INTERFACE;
303 adj_index_to_sw_if_index (vm, lm, ip6_lookup_next_nodes, adj_index0,
304 sw_if_index, verbose);
305 if ((~0 == sw_if_index0) && (~0 == sw_if_index))
307 vlib_buffer_free (vm, &bi0, 1);
308 return SEND_PING_NO_INTERFACE;
310 vnet_buffer (p0)->sw_if_index[VLIB_RX] = sw_if_index0;
312 h0 = vlib_buffer_get_current (p0);
314 /* Fill in ip6 header fields */
315 h0->ip6.ip_version_traffic_class_and_flow_label =
316 clib_host_to_net_u32 (0x6 << 28);
317 h0->ip6.payload_length = 0; /* Set below */
318 h0->ip6.protocol = IP_PROTOCOL_ICMP6;
319 h0->ip6.hop_limit = 255;
320 h0->ip6.dst_address = *pa6;
321 h0->ip6.src_address = *pa6;
323 /* Fill in the correct source now */
324 ip6_address_t *a = ip6_interface_first_address (im, sw_if_index0);
325 h0->ip6.src_address = a[0];
327 /* Fill in icmp fields */
328 h0->icmp.type = ICMP6_echo_request;
330 h0->icmp.checksum = 0;
333 init_icmp46_echo_request (&h0->icmp_echo, seq_host, id_host, data_len);
334 h0->icmp_echo.time_sent = vlib_time_now (vm);
336 /* Fix up the lengths */
337 h0->ip6.payload_length =
338 clib_host_to_net_u16 (data_len + sizeof (icmp46_header_t));
340 p0->current_length = clib_net_to_host_u16 (h0->ip6.payload_length) +
341 STRUCT_OFFSET_OF (icmp6_echo_request_header_t, icmp);
343 /* Calculate the ICMP checksum */
344 h0->icmp.checksum = 0;
346 ip6_tcp_udp_icmp_compute_checksum (vm, 0, &h0->ip6, &bogus_length);
348 /* Enqueue the packet right now */
349 f = vlib_get_frame_to_node (vm, ip6_lookup_node.index);
350 to_next = vlib_frame_vector_args (f);
353 vlib_put_frame_to_node (vm, ip6_lookup_node.index, f);
358 static send_ip46_ping_result_t
359 send_ip4_ping (vlib_main_t * vm,
363 u16 seq_host, u16 id_host, u16 data_len, u8 verbose)
365 icmp4_echo_request_header_t *h0;
368 ip_lookup_main_t *lm = &im->lookup_main;
376 if (vlib_buffer_alloc (vm, &bi0, 1) != 1)
377 return SEND_PING_ALLOC_FAIL;
379 p0 = vlib_get_buffer (vm, bi0);
381 /* Determine sw_if_index0 of the source intf, may be force-set via sw_if_index. */
382 vnet_buffer (p0)->sw_if_index[VLIB_RX] = 0;
383 vnet_buffer (p0)->sw_if_index[VLIB_TX] = ~0; /* use interface VRF */
385 adj_index0 = fib_entry_get_adj(ip4_fib_table_lookup(
386 ip4_fib_get(fib_index0), pa4, 32));
388 if (ADJ_INDEX_INVALID == adj_index0)
390 vlib_buffer_free (vm, &bi0, 1);
391 return SEND_PING_NO_INTERFACE;
395 adj_index_to_sw_if_index (vm, lm, ip4_lookup_next_nodes, adj_index0,
396 sw_if_index, verbose);
397 if ((~0 == sw_if_index0) && (~0 == sw_if_index))
399 vlib_buffer_free (vm, &bi0, 1);
400 return SEND_PING_NO_INTERFACE;
402 vnet_buffer (p0)->sw_if_index[VLIB_RX] = sw_if_index0;
404 h0 = vlib_buffer_get_current (p0);
406 /* Fill in ip4 header fields */
407 h0->ip4.checksum = 0;
408 h0->ip4.ip_version_and_header_length = 0x45;
410 h0->ip4.length = 0; /* Set below */
411 h0->ip4.fragment_id = 0;
412 h0->ip4.flags_and_fragment_offset = 0;
414 h0->ip4.protocol = IP_PROTOCOL_ICMP;
415 h0->ip4.dst_address = *pa4;
416 h0->ip4.src_address = *pa4;
418 /* Fill in the correct source now */
419 if_add_index0 = lm->if_address_pool_index_by_sw_if_index[sw_if_index0];
420 if (PREDICT_TRUE (if_add_index0 != ~0))
422 ip_interface_address_t *if_add =
423 pool_elt_at_index (lm->if_address_pool, if_add_index0);
424 ip4_address_t *if_ip = ip_interface_address_get_address (lm, if_add);
425 h0->ip4.src_address = *if_ip;
428 vlib_cli_output (vm, "Source address: %U",
429 format_ip4_address, &h0->ip4.src_address);
433 /* Fill in icmp fields */
434 h0->icmp.type = ICMP4_echo_request;
436 h0->icmp.checksum = 0;
439 init_icmp46_echo_request (&h0->icmp_echo, seq_host, id_host, data_len);
440 h0->icmp_echo.time_sent = vlib_time_now (vm);
442 /* Fix up the lengths */
444 clib_host_to_net_u16 (data_len + sizeof (icmp46_header_t) +
445 sizeof (ip4_header_t));
447 p0->current_length = clib_net_to_host_u16 (h0->ip4.length);
449 /* Calculate the IP and ICMP checksums */
450 h0->ip4.checksum = ip4_header_checksum (&(h0->ip4));
452 ~ip_csum_fold (ip_incremental_checksum (0, &(h0->icmp),
453 p0->current_length - sizeof (ip4_header_t)));
455 /* Enqueue the packet right now */
456 f = vlib_get_frame_to_node (vm, ip4_lookup_node.index);
457 to_next = vlib_frame_vector_args (f);
460 vlib_put_frame_to_node (vm, ip4_lookup_node.index, f);
467 print_ip6_icmp_reply (vlib_main_t * vm, u32 bi0)
469 vlib_buffer_t *b0 = vlib_get_buffer (vm,
471 icmp6_echo_request_header_t *h0 = vlib_buffer_get_current (b0);
472 f64 rtt = vlib_time_now (vm) - h0->icmp_echo.time_sent;
475 "%d bytes from %U: icmp_seq=%d ttl=%d time=%.4f ms",
476 clib_host_to_net_u16 (h0->ip6.payload_length),
478 &h0->ip6.src_address,
479 clib_host_to_net_u16 (h0->icmp_echo.seq),
480 h0->ip6.hop_limit, rtt * 1000.0);
484 print_ip4_icmp_reply (vlib_main_t * vm, u32 bi0)
486 vlib_buffer_t *b0 = vlib_get_buffer (vm,
488 icmp4_echo_request_header_t *h0 = vlib_buffer_get_current (b0);
489 f64 rtt = vlib_time_now (vm) - h0->icmp_echo.time_sent;
491 clib_host_to_net_u16 (h0->ip4.length) -
492 (4 * (0xF & h0->ip4.ip_version_and_header_length));
495 "%d bytes from %U: icmp_seq=%d ttl=%d time=%.4f ms",
498 &h0->ip4.src_address,
499 clib_host_to_net_u16 (h0->icmp_echo.seq),
500 h0->ip4.ttl, rtt * 1000.0);
505 * Perform the ping run with the given parameters in the current CLI process.
506 * Depending on whether pa4 or pa6 is set, runs IPv4 or IPv6 ping.
507 * The amusing side effect is of course if both are set, then both pings are sent.
508 * This behavior can be used to ping a dualstack host over IPv4 and IPv6 at once.
512 run_ping_ip46_address (vlib_main_t * vm, ip4_address_t * pa4,
513 ip6_address_t * pa6, u32 sw_if_index,
514 f64 ping_interval, u32 ping_repeat, u32 data_len,
518 ping_main_t *pm = &ping_main;
519 uword curr_proc = vlib_current_process (vm);
523 u32 ping_run_index = 0;
526 static u32 rand_seed = 0;
528 if (PREDICT_FALSE(!rand_seed))
529 rand_seed = random_default_seed();
531 icmp_id = random_u32(&rand_seed) & 0xffff;
533 while (hash_get (pm->ping_run_by_icmp_id, icmp_id))
535 vlib_cli_output (vm, "ICMP ID collision at %d, incrementing", icmp_id);
538 pool_get (pm->ping_runs, pr);
539 ping_run_index = pr - pm->ping_runs;
540 pr->cli_process_id = curr_proc;
541 pr->icmp_id = icmp_id;
542 hash_set (pm->ping_run_by_icmp_id, icmp_id, ping_run_index);
543 for (i = 1; i <= ping_repeat; i++)
546 f64 time_ping_sent = vlib_time_now (vm);
547 /* Reset pr: running ping in other process could have changed pm->ping_runs */
548 pr = vec_elt_at_index (pm->ping_runs, ping_run_index);
551 (SEND_PING_OK == send_ip6_ping (vm, ping_main.ip6_main, pa6,
552 sw_if_index, i, icmp_id, data_len,
558 (SEND_PING_OK == send_ip4_ping (vm, ping_main.ip4_main, pa4,
559 sw_if_index, i, icmp_id, data_len,
564 while ((i <= ping_repeat)
567 time_ping_sent + ping_interval - vlib_time_now (vm)) > 0.0))
569 uword event_type, *event_data = 0;
570 vlib_process_wait_for_event_or_clock (vm, sleep_interval);
571 event_type = vlib_process_get_events (vm, &event_data);
574 case ~0: /* no events => timeout */
576 case PING_RESPONSE_IP6:
579 for (i = 0; i < vec_len (event_data); i++)
581 u32 bi0 = event_data[0];
582 print_ip6_icmp_reply (vm, bi0);
586 vlib_buffer_free (vm, &bi0, 1);
591 case PING_RESPONSE_IP4:
594 for (i = 0; i < vec_len (event_data); i++)
596 u32 bi0 = event_data[0];
597 print_ip4_icmp_reply (vm, bi0);
601 vlib_buffer_free (vm, &bi0, 1);
607 /* someone pressed a key, abort */
608 vlib_cli_output (vm, "Aborted due to a keypress.");
614 vlib_cli_output (vm, "\n");
618 n_requests) ? 0 : 100.0 * ((float) n_requests -
619 (float) n_replies) / (float) n_requests;
621 "Statistics: %u sent, %u received, %f%% packet loss\n",
622 n_requests, n_replies, loss);
623 /* Reset pr: running ping in other process could have changed pm->ping_runs */
624 pr = vec_elt_at_index (pm->ping_runs, ping_run_index);
625 hash_unset (pm->ping_run_by_icmp_id, icmp_id);
626 pool_put (pm->ping_runs, pr);
634 static clib_error_t *
635 ping_ip_address (vlib_main_t * vm,
636 unformat_input_t * input, vlib_cli_command_t * cmd)
640 clib_error_t *error = 0;
642 u8 ping_ip4, ping_ip6;
643 vnet_main_t *vnm = vnet_get_main ();
644 u32 data_len = PING_DEFAULT_DATA_LEN;
646 f64 ping_interval = PING_DEFAULT_INTERVAL;
647 ping_ip4 = ping_ip6 = 0;
650 if (unformat (input, "%U", unformat_ip4_address, &a4))
654 else if (unformat (input, "%U", unformat_ip6_address, &a6))
658 else if (unformat (input, "ipv4"))
660 if (unformat (input, "%U", unformat_ip4_address, &a4))
667 clib_error_return (0,
668 "expecting IPv4 address but got `%U'",
669 format_unformat_error, input);
672 else if (unformat (input, "ipv6"))
674 if (unformat (input, "%U", unformat_ip6_address, &a6))
681 clib_error_return (0,
682 "expecting IPv6 address but got `%U'",
683 format_unformat_error, input);
689 clib_error_return (0,
690 "expecting IP4/IP6 address `%U'. Usage: ping <addr> [source <intf>] [size <datasz>] [repeat <count>] [verbose]",
691 format_unformat_error, input);
695 /* allow for the second AF in the same ping */
696 if (!ping_ip4 && (unformat (input, "ipv4")))
698 if (unformat (input, "%U", unformat_ip4_address, &a4))
703 else if (!ping_ip6 && (unformat (input, "ipv6")))
705 if (unformat (input, "%U", unformat_ip6_address, &a6))
711 /* parse the rest of the parameters in a cycle */
712 while (!unformat_eof (input, NULL))
714 if (unformat (input, "source"))
717 (input, unformat_vnet_sw_interface, vnm, &sw_if_index))
720 clib_error_return (0,
721 "unknown interface `%U'",
722 format_unformat_error, input);
726 else if (unformat (input, "size"))
728 if (!unformat (input, "%u", &data_len))
731 clib_error_return (0,
732 "expecting size but got `%U'",
733 format_unformat_error, input);
737 else if (unformat (input, "interval"))
739 if (!unformat (input, "%f", &ping_interval))
742 clib_error_return (0,
743 "expecting interval (floating point number) got `%U'",
744 format_unformat_error, input);
748 else if (unformat (input, "repeat"))
750 if (!unformat (input, "%u", &ping_repeat))
753 clib_error_return (0,
754 "expecting repeat count but got `%U'",
755 format_unformat_error, input);
759 else if (unformat (input, "verbose"))
765 error = clib_error_return (0, "unknown input `%U'",
766 format_unformat_error, input);
771 run_ping_ip46_address (vm, ping_ip4 ? &a4 : NULL, ping_ip6 ? &a6 : NULL,
772 sw_if_index, ping_interval, ping_repeat, data_len,
779 * This command sends an ICMP ECHO_REQUEST to network hosts. The address
780 * can be an IPv4 or IPv6 address (or both at the same time).
784 * Example of how ping an IPv4 address:
785 * @cliexstart{ping 172.16.1.2 source GigabitEthernet2/0/0 repeat 2}
786 * 64 bytes from 172.16.1.2: icmp_seq=1 ttl=64 time=.1090 ms
787 * 64 bytes from 172.16.1.2: icmp_seq=2 ttl=64 time=.0914 ms
789 * Statistics: 2 sent, 2 received, 0% packet loss
792 * Example of how ping both an IPv4 address and IPv6 address at the same time:
793 * @cliexstart{ping 172.16.1.2 ipv6 fe80::24a5:f6ff:fe9c:3a36 source GigabitEthernet2/0/0 repeat 2 verbose}
794 * Adjacency index: 10, sw_if_index: 1
795 * Adj: ip6-discover-neighbor
797 * Forced set interface: 1
798 * Adjacency index: 0, sw_if_index: 4294967295
801 * Forced set interface: 1
802 * Source address: 172.16.1.1
803 * 64 bytes from 172.16.1.2: icmp_seq=1 ttl=64 time=.1899 ms
804 * Adjacency index: 10, sw_if_index: 1
805 * Adj: ip6-discover-neighbor
807 * Forced set interface: 1
808 * Adjacency index: 0, sw_if_index: 4294967295
811 * Forced set interface: 1
812 * Source address: 172.16.1.1
813 * 64 bytes from 172.16.1.2: icmp_seq=2 ttl=64 time=.0910 ms
815 * Statistics: 4 sent, 2 received, 50% packet loss
820 VLIB_CLI_COMMAND (ping_command, static) =
823 .function = ping_ip_address,
824 .short_help = "ping {<ip-addr> | ipv4 <ip4-addr> | ipv6 <ip6-addr>} [ipv4 <ip4-addr> | ipv6 <ip6-addr>] [source <interface>] [size <pktsize>] [interval <sec>] [repeat <cnt>] [verbose]",
828 static clib_error_t *
829 ping_cli_init (vlib_main_t * vm)
831 ping_main_t *pm = &ping_main;
832 pm->ip6_main = &ip6_main;
833 pm->ip4_main = &ip4_main;
834 icmp6_register_type (vm, ICMP6_echo_reply, ip6_icmp_echo_reply_node.index);
835 ip4_icmp_register_type (vm, ICMP4_echo_reply,
836 ip4_icmp_echo_reply_node.index);
840 VLIB_INIT_FUNCTION (ping_cli_init);