2 * Object oriented C module to send ICMP and ICMPv6 `echo's.
3 * Copyright (C) 2006-2014 Florian octo Forster <ff at octo.it>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; only version 2 of the License is
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
29 # include <inttypes.h>
33 # error "You don't have the standard C99 header files installed"
34 #endif /* STDC_HEADERS */
44 #if TIME_WITH_SYS_TIME
45 # include <sys/time.h>
49 # include <sys/time.h>
56 # include <sys/socket.h>
59 # include <netinet/in.h>
62 # include <netinet/ip.h>
66 # include <netdb.h> /* NI_MAXHOST */
74 #include <sys/types.h>
81 # define NCURSES_OPAQUE 1
82 /* http://newsgroups.derkeiler.com/Archive/Rec/rec.games.roguelike.development/2010-09/msg00050.html */
83 # define _X_OPEN_SOURCE_EXTENDED
85 # if HAVE_NCURSESW_NCURSES_H
86 # include <ncursesw/ncurses.h>
91 # define OPING_GREEN 1
92 # define OPING_YELLOW 2
94 # define OPING_GREEN_HIST 4
95 # define OPING_YELLOW_HIST 5
96 # define OPING_RED_HIST 6
98 double const threshold_green = 0.8;
99 double const threshold_yellow = 0.95;
101 static char const * const hist_symbols_utf8[] = {
102 "▁", "▂", "▃", "▄", "▅", "▆", "▇", "█" };
103 static size_t const hist_symbols_utf8_num = sizeof (hist_symbols_utf8)
104 / sizeof (hist_symbols_utf8[0]);
106 /* scancodes for 6 levels of horizontal bars, ncurses-specific */
107 /* those are not the usual constants because those are not constant */
108 static int const hist_symbols_acs[] = {
109 115, /* ACS_S9 "⎽" */
110 114, /* ACS_S7 "⎼" */
111 113, /* ACS_S5 "─" */
112 112, /* ACS_S3 "⎻" */
115 static size_t const hist_symbols_acs_num = sizeof (hist_symbols_acs)
116 / sizeof (hist_symbols_acs[0]);
118 /* use different colors without a background for scancodes */
119 static int const hist_colors_utf8[] = {
120 OPING_GREEN_HIST, OPING_YELLOW_HIST, OPING_RED_HIST };
121 static int const hist_colors_acs[] = {
122 OPING_GREEN, OPING_YELLOW, OPING_RED };
123 /* assuming that both arrays are the same size */
124 static size_t const hist_colors_num = sizeof (hist_colors_utf8)
125 / sizeof (hist_colors_utf8[0]);
129 #define BOXPLOT_WHISKER_BAR (113 | A_ALTCHARSET)
131 #define BOXPLOT_WHISKER_LEFT_END (116 | A_ALTCHARSET)
133 #define BOXPLOT_WHISKER_RIGHT_END (117 | A_ALTCHARSET)
135 #define BOXPLOT_BOX ' '
137 #define BOXPLOT_MEDIAN (120 | A_ALTCHARSET)
141 #ifndef _POSIX_SAVED_IDS
142 # define _POSIX_SAVED_IDS 0
145 #ifndef IPTOS_MINCOST
146 # define IPTOS_MINCOST 0x02
149 /* Remove GNU specific __attribute__ settings when using another compiler */
151 # define __attribute__(x) /**/
154 typedef struct ping_context
156 char host[NI_MAXHOST];
157 char addr[NI_MAXHOST];
163 double latency_total;
165 #ifndef HISTORY_SIZE_MAX
166 # define HISTORY_SIZE_MAX 900
168 /* The last n RTTs in the order they were sent. */
169 double history_by_time[HISTORY_SIZE_MAX];
171 /* Current number of entries in the history. This is a value between 0
172 * and HISTORY_SIZE_MAX. */
175 /* Number "received" entries in the history, i.e. non-NAN entries. */
176 size_t history_received;
178 /* Index of the next RTT to be written to history_by_time. This wraps
179 * around to 0 once the histroty has grown to HISTORY_SIZE_MAX. */
180 size_t history_index;
182 /* The last history_size RTTs sorted by value. timed out packets (NAN
183 * entries) are sorted to the back. */
184 double history_by_value[HISTORY_SIZE_MAX];
186 /* If set to true, history_by_value has to be re-calculated. */
194 static double opt_interval = 1.0;
195 static int opt_addrfamily = PING_DEF_AF;
196 static char *opt_srcaddr = NULL;
197 static char *opt_device = NULL;
198 static char *opt_mark = NULL;
199 static char *opt_filename = NULL;
200 static int opt_count = -1;
201 static int opt_send_ttl = 64;
202 static uint8_t opt_send_qos = 0;
203 #define OPING_DEFAULT_PERCENTILE 95.0
204 static double opt_percentile = -1.0;
205 static double opt_exit_status_threshold = 1.0;
207 static int opt_show_graph = 1;
208 static int opt_utf8 = 0;
211 static int host_num = 0;
214 static WINDOW *main_win = NULL;
217 static void sigint_handler (int signal) /* {{{ */
219 /* Make compiler happy */
223 } /* }}} void sigint_handler */
225 static ping_context_t *context_create (void) /* {{{ */
229 if ((ret = malloc (sizeof (ping_context_t))) == NULL)
232 memset (ret, '\0', sizeof (ping_context_t));
234 ret->latency_total = 0.0;
241 } /* }}} ping_context_t *context_create */
243 static void context_destroy (ping_context_t *context) /* {{{ */
249 if (context->window != NULL)
251 delwin (context->window);
252 context->window = NULL;
257 } /* }}} void context_destroy */
259 static int compare_double (void const *arg0, void const *arg1) /* {{{ */
261 double dbl0 = *((double *) arg0);
262 double dbl1 = *((double *) arg1);
271 else if (isnan (dbl1))
273 else if (dbl0 < dbl1)
275 else if (dbl0 > dbl1)
279 } /* }}} int compare_double */
281 static void clean_history (ping_context_t *ctx) /* {{{ */
285 if (!ctx->history_dirty)
288 /* Copy all values from by_time to by_value. */
289 memcpy (ctx->history_by_value, ctx->history_by_time,
290 sizeof (ctx->history_by_time));
293 qsort (ctx->history_by_value, ctx->history_size, sizeof
294 (ctx->history_by_value[0]), compare_double);
296 /* Update the number of received RTTs. */
297 ctx->history_received = 0;
298 for (i = 0; i < ctx->history_size; i++)
299 if (!isnan (ctx->history_by_value[i]))
300 ctx->history_received++;
303 ctx->history_dirty = 0;
304 } /* }}} void clean_history */
306 static double percentile_to_latency (ping_context_t *ctx, /* {{{ */
313 /* Not a single packet was received successfully. */
314 if (ctx->history_received == 0)
317 if (percentile <= 0.0)
319 else if (percentile >= 100.0)
320 index = ctx->history_received - 1;
323 index = (size_t) ceil ((percentile / 100.0) * ((double) ctx->history_received));
328 return (ctx->history_by_value[index]);
329 } /* }}} double percentile_to_latency */
332 static double latency_to_ratio (ping_context_t *ctx, /* {{{ */
341 /* Not a single packet was received successfully. */
342 if (ctx->history_received == 0)
346 high = ctx->history_received - 1;
348 if (latency < ctx->history_by_value[low])
350 else if (latency >= ctx->history_by_value[high])
353 /* Do a binary search for the latency. This will work even when the
354 * exact latency is not in the array. If the latency is in the array
355 * multiple times, "low" will be set to the index of the last
356 * occurrence. The value at index "high" will be larger than the
357 * searched for latency (assured by the above "if" block. */
358 while ((high - low) > 1)
360 index = (high + low) / 2;
362 if (ctx->history_by_value[index] > latency)
368 assert (ctx->history_by_value[high] > latency);
369 assert (ctx->history_by_value[low] <= latency);
371 if (ctx->history_by_value[low] == latency)
376 return (((double) (index + 1)) / ((double) ctx->history_received));
377 } /* }}} double latency_to_ratio */
380 static double context_get_packet_loss (const ping_context_t *ctx) /* {{{ */
385 if (ctx->req_sent < 1)
388 return (100.0 * (ctx->req_sent - ctx->req_rcvd)
389 / ((double) ctx->req_sent));
390 } /* }}} double context_get_packet_loss */
392 static int ping_initialize_contexts (pingobj_t *ping) /* {{{ */
394 pingobj_iter_t *iter;
401 for (iter = ping_iterator_get (ping);
403 iter = ping_iterator_next (iter))
405 ping_context_t *context;
408 context = context_create ();
409 context->index = index;
411 buffer_size = sizeof (context->host);
412 ping_iterator_get_info (iter, PING_INFO_HOSTNAME, context->host, &buffer_size);
414 buffer_size = sizeof (context->addr);
415 ping_iterator_get_info (iter, PING_INFO_ADDRESS, context->addr, &buffer_size);
417 ping_iterator_set_context (iter, (void *) context);
423 } /* }}} int ping_initialize_contexts */
425 static void usage_exit (const char *name, int status) /* {{{ */
427 fprintf (stderr, "Usage: %s [OPTIONS] "
428 "-f filename | host [host [host ...]]\n"
430 "\nAvailable options:\n"
431 " -4|-6 force the use of IPv4 or IPv6\n"
432 " -c count number of ICMP packets to send\n"
433 " -i interval interval with which to send ICMP packets\n"
434 " -t ttl time to live for each ICMP packet\n"
435 " -Q qos Quality of Service (QoS) of outgoing packets\n"
436 " Use \"-Q help\" for a list of valid options.\n"
437 " -I srcaddr source address\n"
438 " -D device outgoing interface name\n"
439 " -m mark mark to set on outgoing packets\n"
440 " -f filename filename to read hosts from\n"
442 " -u / -U force / disable UTF-8 output\n"
443 " -g graph graph type to draw\n"
445 " -P percent Report the n'th percentile of latency\n"
446 " -Z percent Exit with non-zero exit status if more than this percentage of\n"
447 " probes timed out. (default: never)\n"
449 "\noping "PACKAGE_VERSION", http://noping.cc/\n"
450 "by Florian octo Forster <ff@octo.it>\n"
451 "for contributions see `AUTHORS'\n",
454 } /* }}} void usage_exit */
456 __attribute__((noreturn))
457 static void usage_qos_exit (const char *arg, int status) /* {{{ */
460 fprintf (stderr, "Invalid QoS argument: \"%s\"\n\n", arg);
462 fprintf (stderr, "Valid QoS arguments (option \"-Q\") are:\n"
464 " Differentiated Services (IPv4 and IPv6, RFC 2474)\n"
466 " be Best Effort (BE, default PHB).\n"
467 " ef Expedited Forwarding (EF) PHB group (RFC 3246).\n"
468 " (low delay, low loss, low jitter)\n"
469 " va Voice Admit (VA) DSCP (RFC 5865).\n"
470 " (capacity-admitted traffic)\n"
471 " af[1-4][1-3] Assured Forwarding (AF) PHB group (RFC 2597).\n"
472 " For example: \"af12\" (class 1, precedence 2)\n"
473 " cs[0-7] Class Selector (CS) PHB group (RFC 2474).\n"
474 " For example: \"cs1\" (priority traffic)\n"
476 " Type of Service (IPv4, RFC 1349, obsolete)\n"
478 " lowdelay (%#04x) minimize delay\n"
479 " throughput (%#04x) maximize throughput\n"
480 " reliability (%#04x) maximize reliability\n"
481 " mincost (%#04x) minimize monetary cost\n"
483 " Specify manually\n"
485 " 0x00 - 0xff Hexadecimal numeric specification.\n"
486 " 0 - 255 Decimal numeric specification.\n"
488 (unsigned int) IPTOS_LOWDELAY,
489 (unsigned int) IPTOS_THROUGHPUT,
490 (unsigned int) IPTOS_RELIABILITY,
491 (unsigned int) IPTOS_MINCOST);
494 } /* }}} void usage_qos_exit */
496 static int set_opt_send_qos (const char *opt) /* {{{ */
501 if (strcasecmp ("help", opt) == 0)
502 usage_qos_exit (/* arg = */ NULL, /* status = */ EXIT_SUCCESS);
503 /* DiffServ (RFC 2474): */
504 /* - Best effort (BE) */
505 else if (strcasecmp ("be", opt) == 0)
507 /* - Expedited Forwarding (EF, RFC 3246) */
508 else if (strcasecmp ("ef", opt) == 0)
509 opt_send_qos = 0xB8; /* == 0x2E << 2 */
510 /* - Voice Admit (VA, RFC 5865) */
511 else if (strcasecmp ("va", opt) == 0)
512 opt_send_qos = 0xB0; /* == 0x2D << 2 */
513 /* - Assured Forwarding (AF, RFC 2597) */
514 else if ((strncasecmp ("af", opt, strlen ("af")) == 0)
515 && (strlen (opt) == 4))
521 /* There are four classes, AF1x, AF2x, AF3x, and AF4x. */
524 else if (opt[2] == '2')
526 else if (opt[2] == '3')
528 else if (opt[2] == '4')
531 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_SUCCESS);
533 /* In each class, there are three precedences, AFx1, AFx2, and AFx3 */
536 else if (opt[3] == '2')
538 else if (opt[3] == '3')
541 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_SUCCESS);
543 dscp = (8 * class) + (2 * prec);
544 /* The lower two bits are used for Explicit Congestion Notification (ECN) */
545 opt_send_qos = dscp << 2;
547 /* - Class Selector (CS) */
548 else if ((strncasecmp ("cs", opt, strlen ("cs")) == 0)
549 && (strlen (opt) == 3))
553 if ((opt[2] < '0') || (opt[2] > '7'))
554 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_FAILURE);
556 /* Not exactly legal by the C standard, but I don't know of any
557 * system not supporting this hack. */
558 class = ((uint8_t) opt[2]) - ((uint8_t) '0');
559 opt_send_qos = class << 5;
561 /* Type of Service (RFC 1349) */
562 else if (strcasecmp ("lowdelay", opt) == 0)
563 opt_send_qos = IPTOS_LOWDELAY;
564 else if (strcasecmp ("throughput", opt) == 0)
565 opt_send_qos = IPTOS_THROUGHPUT;
566 else if (strcasecmp ("reliability", opt) == 0)
567 opt_send_qos = IPTOS_RELIABILITY;
568 else if (strcasecmp ("mincost", opt) == 0)
569 opt_send_qos = IPTOS_MINCOST;
578 value = strtoul (opt, &endptr, /* base = */ 0);
579 if ((errno != 0) || (endptr == opt)
580 || (endptr == NULL) || (*endptr != 0)
582 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_FAILURE);
584 opt_send_qos = (uint8_t) value;
588 } /* }}} int set_opt_send_qos */
590 static char *format_qos (uint8_t qos, char *buffer, size_t buffer_size) /* {{{ */
602 case 0x00: dscp_str = "be"; break;
603 case 0x2e: dscp_str = "ef"; break;
604 case 0x2d: dscp_str = "va"; break;
605 case 0x0a: dscp_str = "af11"; break;
606 case 0x0c: dscp_str = "af12"; break;
607 case 0x0e: dscp_str = "af13"; break;
608 case 0x12: dscp_str = "af21"; break;
609 case 0x14: dscp_str = "af22"; break;
610 case 0x16: dscp_str = "af23"; break;
611 case 0x1a: dscp_str = "af31"; break;
612 case 0x1c: dscp_str = "af32"; break;
613 case 0x1e: dscp_str = "af33"; break;
614 case 0x22: dscp_str = "af41"; break;
615 case 0x24: dscp_str = "af42"; break;
616 case 0x26: dscp_str = "af43"; break;
617 case 0x08: dscp_str = "cs1"; break;
618 case 0x10: dscp_str = "cs2"; break;
619 case 0x18: dscp_str = "cs3"; break;
620 case 0x20: dscp_str = "cs4"; break;
621 case 0x28: dscp_str = "cs5"; break;
622 case 0x30: dscp_str = "cs6"; break;
623 case 0x38: dscp_str = "cs7"; break;
624 default: dscp_str = NULL;
629 case 0x01: ecn_str = ",ecn(1)"; break;
630 case 0x02: ecn_str = ",ecn(0)"; break;
631 case 0x03: ecn_str = ",ce"; break;
632 default: ecn_str = "";
635 if (dscp_str == NULL)
636 snprintf (buffer, buffer_size, "0x%02x%s", dscp, ecn_str);
638 snprintf (buffer, buffer_size, "%s%s", dscp_str, ecn_str);
639 buffer[buffer_size - 1] = 0;
642 } /* }}} char *format_qos */
644 static int read_options (int argc, char **argv) /* {{{ */
650 optchar = getopt (argc, argv, "46c:hi:I:t:Q:f:D:Z:P:m:"
663 opt_addrfamily = (optchar == '4') ? AF_INET : AF_INET6;
669 new_count = atoi (optarg);
672 opt_count = new_count;
674 if ((opt_percentile < 0.0) && (opt_count < 20))
675 opt_percentile = 100.0 * (opt_count - 1) / opt_count;
678 fprintf(stderr, "Ignoring invalid count: %s\n",
685 if (opt_filename != NULL)
687 opt_filename = strdup (optarg);
694 new_interval = atof (optarg);
695 if (new_interval < 0.001)
696 fprintf (stderr, "Ignoring invalid interval: %s\n",
699 opt_interval = new_interval;
705 if (opt_srcaddr != NULL)
707 opt_srcaddr = strdup (optarg);
722 new_send_ttl = atoi (optarg);
723 if ((new_send_ttl > 0) && (new_send_ttl < 256))
724 opt_send_ttl = new_send_ttl;
726 fprintf (stderr, "Ignoring invalid TTL argument: %s\n",
732 set_opt_send_qos (optarg);
737 double new_percentile;
738 new_percentile = atof (optarg);
739 if (isnan (new_percentile)
740 || (new_percentile < 0.1)
741 || (new_percentile > 100.0))
742 fprintf (stderr, "Ignoring invalid percentile: %s\n",
745 opt_percentile = new_percentile;
751 if (strcasecmp ("none", optarg) == 0)
753 else if (strcasecmp ("prettyping", optarg) == 0)
755 else if (strcasecmp ("histogram", optarg) == 0)
757 else if (strcasecmp ("boxplot", optarg) == 0)
760 fprintf (stderr, "Unknown graph option: %s\n", optarg);
777 tmp = strtod (optarg, &endptr);
778 if ((errno != 0) || (endptr == NULL) || (*endptr != 0) || (tmp < 0.0) || (tmp > 100.0))
780 fprintf (stderr, "Ignoring invalid -Z argument: %s\n", optarg);
781 fprintf (stderr, "The \"-Z\" option requires a numeric argument between 0 and 100.\n");
784 opt_exit_status_threshold = tmp / 100.0;
790 usage_exit (argv[0], 0);
794 usage_exit (argv[0], 1);
798 if (opt_percentile <= 0.0)
799 opt_percentile = OPING_DEFAULT_PERCENTILE;
802 } /* }}} read_options */
804 static void time_normalize (struct timespec *ts) /* {{{ */
806 while (ts->tv_nsec < 0)
815 ts->tv_nsec += 1000000000;
818 while (ts->tv_nsec >= 1000000000)
821 ts->tv_nsec -= 1000000000;
823 } /* }}} void time_normalize */
825 static void time_calc (struct timespec *ts_dest, /* {{{ */
826 const struct timespec *ts_int,
827 const struct timeval *tv_begin,
828 const struct timeval *tv_end)
830 ts_dest->tv_sec = tv_begin->tv_sec + ts_int->tv_sec;
831 ts_dest->tv_nsec = (tv_begin->tv_usec * 1000) + ts_int->tv_nsec;
832 time_normalize (ts_dest);
834 /* Assure that `(begin + interval) > end'.
835 * This may seem overly complicated, but `tv_sec' is of type `time_t'
836 * which may be `unsigned. *sigh* */
837 if ((tv_end->tv_sec > ts_dest->tv_sec)
838 || ((tv_end->tv_sec == ts_dest->tv_sec)
839 && ((tv_end->tv_usec * 1000) > ts_dest->tv_nsec)))
842 ts_dest->tv_nsec = 0;
846 ts_dest->tv_sec = ts_dest->tv_sec - tv_end->tv_sec;
847 ts_dest->tv_nsec = ts_dest->tv_nsec - (tv_end->tv_usec * 1000);
848 time_normalize (ts_dest);
849 } /* }}} void time_calc */
852 static _Bool has_utf8() /* {{{ */
854 # if HAVE_NCURSESW_NCURSES_H
857 /* Automatically determine */
858 if (strcasecmp ("UTF-8", nl_langinfo (CODESET)) == 0)
863 return ((_Bool) (opt_utf8 - 1));
867 } /* }}} _Bool has_utf8 */
869 static int update_graph_boxplot (ping_context_t *ctx) /* {{{ */
879 if (ctx->history_received == 0)
882 x_max = (size_t) getmaxx (ctx->window);
887 counters = calloc (x_max, sizeof (*counters));
888 ratios = calloc (x_max, sizeof (*ratios));
891 for (i = 0; i < ctx->history_received; i++)
893 double latency = ctx->history_by_value[i] / 1000.0;
894 size_t index = (size_t) (((double) x_max) * latency / opt_interval);
902 /* Sum and calc ratios */
903 ratios[0] = ((double) counters[0]) / ((double) ctx->history_received);
904 for (x = 1; x < x_max; x++)
906 counters[x] += counters[x - 1];
907 ratios[x] = ((double) counters[x]) / ((double) ctx->history_received);
910 for (x = 0; x < x_max; x++)
917 if (ratios[x] >= 0.5)
919 symbol = BOXPLOT_MEDIAN;
922 else if (ratios[x] > 0.25)
924 symbol = BOXPLOT_BOX;
927 else if (ratios[x] > 0.025)
928 symbol = BOXPLOT_WHISKER_BAR;
930 symbol = ' '; /* NOP */
934 if ((ratios[x - 1] < 0.5) && (ratios[x] >= 0.5))
936 symbol = BOXPLOT_MEDIAN;
939 else if (((ratios[x] >= 0.25) && (ratios[x] <= 0.75))
940 || ((ratios[x - 1] < 0.75) && (ratios[x] > 0.75)))
942 symbol = BOXPLOT_BOX;
945 else if ((ratios[x] < 0.5) && (ratios[x] >= 0.025))
947 if (ratios[x - 1] < 0.025)
948 symbol = BOXPLOT_WHISKER_LEFT_END;
950 symbol = BOXPLOT_WHISKER_BAR;
952 else if ((ratios[x] > .5) && (ratios[x] < 0.975))
954 symbol = BOXPLOT_WHISKER_BAR;
956 else if ((ratios[x] >= 0.975) && (ratios[x - 1] < 0.975))
957 symbol = BOXPLOT_WHISKER_RIGHT_END;
961 wattron (ctx->window, A_REVERSE);
962 mvwaddch (ctx->window, /* y = */ 3, /* x = */ (int) (x + 2), symbol);
963 // mvwprintw (ctx->window, /* y = */ 3, /* x = */ (int) (x + 2), symbol);
965 wattroff (ctx->window, A_REVERSE);
971 } /* }}} int update_graph_boxplot */
973 static int update_graph_prettyping (ping_context_t *ctx, /* {{{ */
974 double latency, unsigned int sequence)
978 size_t history_offset;
980 x_max = (size_t) getmaxx (ctx->window);
985 /* Determine the first index in the history we need to draw
988 if (((size_t) x_max) < ctx->history_size) /* window is smaller than history */
990 if (ctx->history_index > x_max)
991 history_offset = ctx->history_index - x_max;
992 else /* wrap around */
993 history_offset = ctx->history_index + ctx->history_size - x_max;
995 else /* window is larger than history */
997 if (ctx->history_index != ctx->history_size) /* no longer growing. */
998 history_offset = ctx->history_index;
1003 for (x = 0; x < x_max; x++)
1008 int color = OPING_RED;
1009 char const *symbol = "!";
1012 if (x >= ctx->history_size)
1014 mvwaddch (ctx->window, /* y = */ 3, /* x = */ x + 2, ' ');
1018 index = (history_offset + x) % ctx->history_size;
1019 latency = ctx->history_by_time[index];
1025 size_t symbols_num = hist_symbols_acs_num;
1026 size_t colors_num = 1;
1028 size_t index_symbols;
1029 size_t index_colors;
1032 /* latency is in milliseconds, opt_interval is in seconds. */
1033 ratio = (latency * 0.001) / opt_interval;
1039 symbols_num = hist_symbols_utf8_num;
1041 if (has_colors () == TRUE)
1042 colors_num = hist_colors_num;
1044 intensity = (size_t) (ratio * ((double) (symbols_num * colors_num)));
1045 if (intensity >= (symbols_num * colors_num))
1046 intensity = (symbols_num * colors_num) - 1;
1048 index_symbols = intensity % symbols_num;
1049 assert (index_symbols < symbols_num);
1051 index_colors = intensity / symbols_num;
1052 assert (index_colors < colors_num);
1056 color = hist_colors_utf8[index_colors];
1057 symbol = hist_symbols_utf8[index_symbols];
1061 color = hist_colors_acs[index_colors];
1062 symbolc = hist_symbols_acs[index_symbols] | A_ALTCHARSET;
1065 else /* if (!(latency >= 0.0)) */
1066 wattron (ctx->window, A_BOLD);
1068 if (has_colors () == TRUE)
1069 wattron (ctx->window, COLOR_PAIR(color));
1072 mvwprintw (ctx->window, /* y = */ 3, /* x = */ x + 2, symbol);
1074 mvwaddch (ctx->window, /* y = */ 3, /* x = */ x + 2, symbolc);
1076 if (has_colors () == TRUE)
1077 wattroff (ctx->window, COLOR_PAIR(color));
1079 /* Use negation here to handle NaN correctly. */
1080 if (!(latency >= 0.0))
1081 wattroff (ctx->window, A_BOLD);
1085 } /* }}} int update_graph_prettyping */
1087 static int update_graph_histogram (ping_context_t *ctx) /* {{{ */
1090 uint32_t *accumulated;
1096 size_t symbols_num = hist_symbols_acs_num;
1098 clean_history (ctx);
1100 if (ctx->history_received == 0)
1104 symbols_num = hist_symbols_utf8_num;
1106 x_max = (size_t) getmaxx (ctx->window);
1111 counters = calloc (x_max, sizeof (*counters));
1112 accumulated = calloc (x_max, sizeof (*accumulated));
1116 for (i = 0; i < ctx->history_received; i++)
1118 double latency = ctx->history_by_value[i] / 1000.0;
1119 size_t index = (size_t) (((double) x_max) * latency / opt_interval);
1125 if (max < counters[index])
1126 max = counters[index];
1130 accumulated[0] = counters[0];
1131 for (x = 1; x < x_max; x++)
1132 accumulated[x] = counters[x] + accumulated[x - 1];
1134 /* Calculate ratios */
1135 for (x = 0; x < x_max; x++)
1137 double height = ((double) counters[x]) / ((double) max);
1138 double ratio_this = ((double) accumulated[x]) / ((double) ctx->history_received);
1139 double ratio_prev = 0.0;
1143 index = (size_t) (height * ((double) symbols_num));
1144 if (index >= symbols_num)
1145 index = symbols_num - 1;
1148 ratio_prev = ((double) accumulated[x - 1]) / ((double) ctx->history_received);
1150 if (has_colors () == TRUE)
1152 if ((ratio_this <= threshold_green)
1153 || ((ratio_prev < threshold_green)
1154 && (ratio_this > threshold_green)))
1155 color = OPING_GREEN;
1156 else if ((ratio_this <= threshold_yellow)
1157 || ((ratio_prev < threshold_yellow)
1158 && (ratio_this > threshold_yellow)))
1159 color = OPING_YELLOW;
1163 wattron (ctx->window, COLOR_PAIR(color));
1166 if (counters[x] == 0)
1167 mvwaddch (ctx->window, /* y = */ 3, /* x = */ x + 2, ' ');
1168 else if (has_utf8 ())
1169 mvwprintw (ctx->window, /* y = */ 3, /* x = */ x + 2,
1170 hist_symbols_utf8[index]);
1172 mvwaddch (ctx->window, /* y = */ 3, /* x = */ x + 2,
1173 hist_symbols_acs[index] | A_ALTCHARSET);
1175 if (has_colors () == TRUE)
1176 wattroff (ctx->window, COLOR_PAIR(color));
1182 } /* }}} int update_graph_histogram */
1184 static int update_stats_from_context (ping_context_t *ctx, pingobj_iter_t *iter) /* {{{ */
1186 double latency = -1.0;
1187 size_t buffer_len = sizeof (latency);
1189 ping_iterator_get_info (iter, PING_INFO_LATENCY,
1190 &latency, &buffer_len);
1192 unsigned int sequence = 0;
1193 buffer_len = sizeof (sequence);
1194 ping_iterator_get_info (iter, PING_INFO_SEQUENCE,
1195 &sequence, &buffer_len);
1198 if ((ctx == NULL) || (ctx->window == NULL))
1201 /* werase (ctx->window); */
1203 box (ctx->window, 0, 0);
1204 wattron (ctx->window, A_BOLD);
1205 mvwprintw (ctx->window, /* y = */ 0, /* x = */ 5,
1207 wattroff (ctx->window, A_BOLD);
1208 wprintw (ctx->window, "ping statistics ");
1209 mvwprintw (ctx->window, /* y = */ 1, /* x = */ 2,
1210 "%i packets transmitted, %i received, %.2f%% packet "
1211 "loss, time %.1fms",
1212 ctx->req_sent, ctx->req_rcvd,
1213 context_get_packet_loss (ctx),
1214 ctx->latency_total);
1215 if (ctx->req_rcvd != 0)
1222 min = percentile_to_latency (ctx, 0.0);
1223 median = percentile_to_latency (ctx, 50.0);
1224 max = percentile_to_latency (ctx, 100.0);
1225 percentile = percentile_to_latency (ctx, opt_percentile);
1227 mvwprintw (ctx->window, /* y = */ 2, /* x = */ 2,
1228 "RTT[ms]: min = %.0f, median = %.0f, p(%.0f) = %.0f, max = %.0f ",
1229 min, median, opt_percentile, percentile, max);
1232 if (opt_show_graph == 1)
1233 update_graph_prettyping (ctx, latency, sequence);
1234 else if (opt_show_graph == 2)
1235 update_graph_histogram (ctx);
1236 else if (opt_show_graph == 3)
1237 update_graph_boxplot (ctx);
1239 wrefresh (ctx->window);
1242 } /* }}} int update_stats_from_context */
1244 static int on_resize (pingobj_t *ping) /* {{{ */
1246 pingobj_iter_t *iter;
1249 int main_win_height;
1250 int box_height = (opt_show_graph == 0) ? 4 : 5;
1252 getmaxyx (stdscr, height, width);
1253 if ((height < 1) || (width < 1))
1256 main_win_height = height - (box_height * host_num);
1257 wresize (main_win, main_win_height, /* width = */ width);
1258 /* Allow scrolling */
1259 scrollok (main_win, TRUE);
1260 /* wsetscrreg (main_win, 0, main_win_height - 1); */
1261 /* Allow hardware accelerated scrolling. */
1262 idlok (main_win, TRUE);
1263 wrefresh (main_win);
1265 for (iter = ping_iterator_get (ping);
1267 iter = ping_iterator_next (iter))
1269 ping_context_t *context;
1271 context = ping_iterator_get_context (iter);
1272 if (context == NULL)
1275 if (context->window != NULL)
1277 delwin (context->window);
1278 context->window = NULL;
1280 context->window = newwin (/* height = */ box_height,
1281 /* width = */ width,
1282 /* y = */ main_win_height + (box_height * context->index),
1289 static int check_resize (pingobj_t *ping) /* {{{ */
1291 int need_resize = 0;
1295 int key = wgetch (stdscr);
1298 else if (key == KEY_RESIZE)
1300 else if (key == 'g')
1302 if (opt_show_graph == 3)
1304 else if (opt_show_graph > 0)
1310 return (on_resize (ping));
1313 } /* }}} int check_resize */
1315 static int pre_loop_hook (pingobj_t *ping) /* {{{ */
1317 pingobj_iter_t *iter;
1320 int main_win_height;
1321 int box_height = (opt_show_graph == 0) ? 4 : 5;
1326 nodelay (stdscr, TRUE);
1328 getmaxyx (stdscr, height, width);
1329 if ((height < 1) || (width < 1))
1332 if (has_colors () == TRUE)
1335 init_pair (OPING_GREEN, COLOR_GREEN, /* default = */ 0);
1336 init_pair (OPING_YELLOW, COLOR_YELLOW, /* default = */ 0);
1337 init_pair (OPING_RED, COLOR_RED, /* default = */ 0);
1338 init_pair (OPING_GREEN_HIST, COLOR_GREEN, COLOR_BLACK);
1339 init_pair (OPING_YELLOW_HIST, COLOR_YELLOW, COLOR_GREEN);
1340 init_pair (OPING_RED_HIST, COLOR_RED, COLOR_YELLOW);
1343 main_win_height = height - (box_height * host_num);
1344 main_win = newwin (/* height = */ main_win_height,
1345 /* width = */ width,
1346 /* y = */ 0, /* x = */ 0);
1347 /* Allow scrolling */
1348 scrollok (main_win, TRUE);
1349 /* wsetscrreg (main_win, 0, main_win_height - 1); */
1350 /* Allow hardware accelerated scrolling. */
1351 idlok (main_win, TRUE);
1352 wmove (main_win, /* y = */ main_win_height - 1, /* x = */ 0);
1353 wrefresh (main_win);
1355 for (iter = ping_iterator_get (ping);
1357 iter = ping_iterator_next (iter))
1359 ping_context_t *context;
1361 context = ping_iterator_get_context (iter);
1362 if (context == NULL)
1365 if (context->window != NULL)
1367 delwin (context->window);
1368 context->window = NULL;
1370 context->window = newwin (/* height = */ box_height,
1371 /* width = */ width,
1372 /* y = */ main_win_height + (box_height * context->index),
1377 /* Don't know what good this does exactly, but without this code
1378 * "check_resize" will be called right after startup and *somehow*
1379 * this leads to display errors. If we purge all initial characters
1380 * here, the problem goes away. "wgetch" is non-blocking due to
1381 * "nodelay" (see above). */
1382 while (wgetch (stdscr) != ERR)
1384 /* eat up characters */;
1388 } /* }}} int pre_loop_hook */
1390 static int pre_sleep_hook (pingobj_t *ping) /* {{{ */
1392 return (check_resize (ping));
1393 } /* }}} int pre_sleep_hook */
1395 static int post_sleep_hook (pingobj_t *ping) /* {{{ */
1397 return (check_resize (ping));
1398 } /* }}} int pre_sleep_hook */
1399 #else /* if !USE_NCURSES */
1400 static int pre_loop_hook (pingobj_t *ping) /* {{{ */
1402 pingobj_iter_t *iter;
1404 for (iter = ping_iterator_get (ping);
1406 iter = ping_iterator_next (iter))
1408 ping_context_t *ctx;
1411 ctx = ping_iterator_get_context (iter);
1416 ping_iterator_get_info (iter, PING_INFO_DATA, NULL, &buffer_size);
1418 printf ("PING %s (%s) %zu bytes of data.\n",
1419 ctx->host, ctx->addr, buffer_size);
1423 } /* }}} int pre_loop_hook */
1425 static int pre_sleep_hook (__attribute__((unused)) pingobj_t *ping) /* {{{ */
1430 } /* }}} int pre_sleep_hook */
1432 static int post_sleep_hook (__attribute__((unused)) pingobj_t *ping) /* {{{ */
1435 } /* }}} int post_sleep_hook */
1438 static void update_context (ping_context_t *ctx, double latency) /* {{{ */
1445 ctx->latency_total += latency;
1452 ctx->history_by_time[ctx->history_index] = latency;
1454 ctx->history_dirty = 1;
1456 /* Update index and size. */
1457 ctx->history_index = (ctx->history_index + 1) % HISTORY_SIZE_MAX;
1458 if (ctx->history_size < HISTORY_SIZE_MAX)
1459 ctx->history_size++;
1460 } /* }}} void update_context */
1462 static void update_host_hook (pingobj_iter_t *iter, /* {{{ */
1463 __attribute__((unused)) int index)
1466 unsigned int sequence;
1469 char recv_qos_str[16];
1472 ping_context_t *context;
1475 buffer_len = sizeof (latency);
1476 ping_iterator_get_info (iter, PING_INFO_LATENCY,
1477 &latency, &buffer_len);
1480 buffer_len = sizeof (sequence);
1481 ping_iterator_get_info (iter, PING_INFO_SEQUENCE,
1482 &sequence, &buffer_len);
1485 buffer_len = sizeof (recv_ttl);
1486 ping_iterator_get_info (iter, PING_INFO_RECV_TTL,
1487 &recv_ttl, &buffer_len);
1490 buffer_len = sizeof (recv_qos);
1491 ping_iterator_get_info (iter, PING_INFO_RECV_QOS,
1492 &recv_qos, &buffer_len);
1495 ping_iterator_get_info (iter, PING_INFO_DATA,
1498 context = (ping_context_t *) ping_iterator_get_context (iter);
1501 # define HOST_PRINTF(...) wprintw(main_win, __VA_ARGS__)
1503 # define HOST_PRINTF(...) printf(__VA_ARGS__)
1506 update_context (context, latency);
1511 if (has_colors () == TRUE)
1514 int color = OPING_GREEN;
1516 ratio = latency_to_ratio (context, latency);
1517 if (ratio < threshold_green)
1518 color = OPING_GREEN;
1519 else if (ratio < threshold_yellow)
1520 color = OPING_YELLOW;
1524 HOST_PRINTF ("%zu bytes from %s (%s): icmp_seq=%u ttl=%i ",
1525 data_len, context->host, context->addr,
1527 format_qos (recv_qos, recv_qos_str, sizeof (recv_qos_str)));
1528 if ((recv_qos != 0) || (opt_send_qos != 0))
1530 HOST_PRINTF ("qos=%s ",
1531 format_qos (recv_qos, recv_qos_str, sizeof (recv_qos_str)));
1533 HOST_PRINTF ("time=");
1534 wattron (main_win, COLOR_PAIR(color));
1535 HOST_PRINTF ("%.2f", latency);
1536 wattroff (main_win, COLOR_PAIR(color));
1537 HOST_PRINTF (" ms\n");
1542 HOST_PRINTF ("%zu bytes from %s (%s): icmp_seq=%u ttl=%i ",
1544 context->host, context->addr,
1545 sequence, recv_ttl);
1546 if ((recv_qos != 0) || (opt_send_qos != 0))
1548 HOST_PRINTF ("qos=%s ",
1549 format_qos (recv_qos, recv_qos_str, sizeof (recv_qos_str)));
1551 HOST_PRINTF ("time=%.2f ms\n", latency);
1556 else /* if (!(latency > 0.0)) */
1559 if (has_colors () == TRUE)
1561 HOST_PRINTF ("echo reply from %s (%s): icmp_seq=%u ",
1562 context->host, context->addr,
1564 wattron (main_win, COLOR_PAIR(OPING_RED) | A_BOLD);
1565 HOST_PRINTF ("timeout");
1566 wattroff (main_win, COLOR_PAIR(OPING_RED) | A_BOLD);
1572 HOST_PRINTF ("echo reply from %s (%s): icmp_seq=%u timeout\n",
1573 context->host, context->addr,
1581 update_stats_from_context (context, iter);
1582 wrefresh (main_win);
1584 } /* }}} void update_host_hook */
1586 /* Prints statistics for each host, cleans up the contexts and returns the
1587 * number of hosts which failed to return more than the fraction
1588 * opt_exit_status_threshold of pings. */
1589 static int post_loop_hook (pingobj_t *ping) /* {{{ */
1591 pingobj_iter_t *iter;
1592 int failure_count = 0;
1598 for (iter = ping_iterator_get (ping);
1600 iter = ping_iterator_next (iter))
1602 ping_context_t *context;
1604 context = ping_iterator_get_context (iter);
1606 printf ("\n--- %s ping statistics ---\n"
1607 "%i packets transmitted, %i received, %.2f%% packet loss, time %.1fms\n",
1608 context->host, context->req_sent, context->req_rcvd,
1609 context_get_packet_loss (context),
1610 context->latency_total);
1613 double pct_failed = 1.0 - (((double) context->req_rcvd)
1614 / ((double) context->req_sent));
1615 if (pct_failed > opt_exit_status_threshold)
1619 if (context->req_rcvd != 0)
1626 min = percentile_to_latency (context, 0.0);
1627 median = percentile_to_latency (context, 50.0);
1628 max = percentile_to_latency (context, 100.0);
1629 percentile = percentile_to_latency (context, opt_percentile);
1631 printf ("RTT[ms]: min = %.0f, median = %.0f, p(%.0f) = %.0f, max = %.0f\n",
1632 min, median, opt_percentile, percentile, max);
1635 ping_iterator_set_context (iter, NULL);
1636 context_destroy (context);
1639 return (failure_count);
1640 } /* }}} int post_loop_hook */
1642 int main (int argc, char **argv) /* {{{ */
1645 pingobj_iter_t *iter;
1647 struct sigaction sigint_action;
1649 struct timeval tv_begin;
1650 struct timeval tv_end;
1651 struct timespec ts_wait;
1652 struct timespec ts_int;
1657 #if _POSIX_SAVED_IDS
1658 uid_t saved_set_uid;
1660 /* Save the old effective user id */
1661 saved_set_uid = geteuid ();
1662 /* Set the effective user ID to the real user ID without changing the
1663 * saved set-user ID */
1664 status = seteuid (getuid ());
1667 fprintf (stderr, "Temporarily dropping privileges "
1668 "failed: %s\n", strerror (errno));
1669 exit (EXIT_FAILURE);
1673 setlocale(LC_ALL, "");
1674 optind = read_options (argc, argv);
1676 #if !_POSIX_SAVED_IDS
1677 /* Cannot temporarily drop privileges -> reject every file but "-". */
1678 if ((opt_filename != NULL)
1679 && (strcmp ("-", opt_filename) != 0)
1680 && (getuid () != geteuid ()))
1682 fprintf (stderr, "Your real and effective user IDs don't "
1683 "match. Reading from a file (option '-f')\n"
1684 "is therefore too risky. You can still read "
1685 "from STDIN using '-f -' if you like.\n"
1687 exit (EXIT_FAILURE);
1691 if ((optind >= argc) && (opt_filename == NULL)) {
1692 usage_exit (argv[0], 1);
1695 if ((ping = ping_construct ()) == NULL)
1697 fprintf (stderr, "ping_construct failed\n");
1701 if (ping_setopt (ping, PING_OPT_TTL, &opt_send_ttl) != 0)
1703 fprintf (stderr, "Setting TTL to %i failed: %s\n",
1704 opt_send_ttl, ping_get_error (ping));
1707 if (ping_setopt (ping, PING_OPT_QOS, &opt_send_qos) != 0)
1709 fprintf (stderr, "Setting TOS to %i failed: %s\n",
1710 opt_send_qos, ping_get_error (ping));
1717 temp_nsec = modf (opt_interval, &temp_sec);
1718 ts_int.tv_sec = (time_t) temp_sec;
1719 ts_int.tv_nsec = (long) (temp_nsec * 1000000000L);
1721 /* printf ("ts_int = %i.%09li\n", (int) ts_int.tv_sec, ts_int.tv_nsec); */
1724 if (opt_addrfamily != PING_DEF_AF)
1725 ping_setopt (ping, PING_OPT_AF, (void *) &opt_addrfamily);
1727 if (opt_srcaddr != NULL)
1729 if (ping_setopt (ping, PING_OPT_SOURCE, (void *) opt_srcaddr) != 0)
1731 fprintf (stderr, "Setting source address failed: %s\n",
1732 ping_get_error (ping));
1736 if (opt_device != NULL)
1738 if (ping_setopt (ping, PING_OPT_DEVICE, (void *) opt_device) != 0)
1740 fprintf (stderr, "Setting device failed: %s\n",
1741 ping_get_error (ping));
1745 if(opt_mark != NULL)
1748 int mark = strtoul(opt_mark, &endp, 0);
1749 if(opt_mark[0] != '\0' && *endp == '\0')
1751 if(ping_setopt(ping, PING_OPT_MARK, (void*)(&mark)) != 0)
1753 fprintf (stderr, "Setting mark failed: %s\n",
1754 ping_get_error (ping));
1758 fprintf(stderr, "Ignoring invalid mark: %s\n", optarg);
1762 if (opt_filename != NULL)
1768 if (strcmp (opt_filename, "-") == 0)
1770 infile = fdopen(0, "r");
1772 infile = fopen(opt_filename, "r");
1776 fprintf (stderr, "Opening %s failed: %s\n",
1777 (strcmp (opt_filename, "-") == 0)
1778 ? "STDIN" : opt_filename,
1783 #if _POSIX_SAVED_IDS
1784 /* Regain privileges */
1785 status = seteuid (saved_set_uid);
1788 fprintf (stderr, "Temporarily re-gaining privileges "
1789 "failed: %s\n", strerror (errno));
1790 exit (EXIT_FAILURE);
1794 while (fgets(line, sizeof(line), infile))
1796 /* Strip whitespace */
1797 if (sscanf(line, "%s", host) != 1)
1800 if ((host[0] == 0) || (host[0] == '#'))
1803 if (ping_host_add(ping, host) < 0)
1805 const char *errmsg = ping_get_error (ping);
1807 fprintf (stderr, "Adding host `%s' failed: %s\n", host, errmsg);
1816 #if _POSIX_SAVED_IDS
1817 /* Drop privileges */
1818 status = seteuid (getuid ());
1821 fprintf (stderr, "Temporarily dropping privileges "
1822 "failed: %s\n", strerror (errno));
1823 exit (EXIT_FAILURE);
1830 #if _POSIX_SAVED_IDS
1831 /* Regain privileges */
1832 status = seteuid (saved_set_uid);
1835 fprintf (stderr, "Temporarily re-gaining privileges "
1836 "failed: %s\n", strerror (errno));
1837 exit (EXIT_FAILURE);
1841 for (i = optind; i < argc; i++)
1843 if (ping_host_add (ping, argv[i]) < 0)
1845 const char *errmsg = ping_get_error (ping);
1847 fprintf (stderr, "Adding host `%s' failed: %s\n", argv[i], errmsg);
1856 /* Permanently drop root privileges if we're setuid-root. */
1857 status = setuid (getuid ());
1860 fprintf (stderr, "Dropping privileges failed: %s\n",
1862 exit (EXIT_FAILURE);
1866 exit (EXIT_FAILURE);
1868 #if _POSIX_SAVED_IDS
1869 saved_set_uid = (uid_t) -1;
1872 ping_initialize_contexts (ping);
1877 memset (&sigint_action, '\0', sizeof (sigint_action));
1878 sigint_action.sa_handler = sigint_handler;
1879 if (sigaction (SIGINT, &sigint_action, NULL) < 0)
1881 perror ("sigaction");
1885 pre_loop_hook (ping);
1887 while (opt_count != 0)
1892 if (gettimeofday (&tv_begin, NULL) < 0)
1894 perror ("gettimeofday");
1898 status = ping_send (ping);
1899 if (status == -EINTR)
1903 else if (status < 0)
1905 fprintf (stderr, "ping_send failed: %s\n",
1906 ping_get_error (ping));
1911 for (iter = ping_iterator_get (ping);
1913 iter = ping_iterator_next (iter))
1915 update_host_hook (iter, index);
1919 pre_sleep_hook (ping);
1921 /* Don't sleep in the last iteration */
1925 if (gettimeofday (&tv_end, NULL) < 0)
1927 perror ("gettimeofday");
1931 time_calc (&ts_wait, &ts_int, &tv_begin, &tv_end);
1933 /* printf ("Sleeping for %i.%09li seconds\n", (int) ts_wait.tv_sec, ts_wait.tv_nsec); */
1934 while ((status = nanosleep (&ts_wait, &ts_wait)) != 0)
1942 perror ("nanosleep");
1947 post_sleep_hook (ping);
1951 } /* while (opt_count != 0) */
1953 /* Returns the number of failed hosts according to -Z. */
1954 status = post_loop_hook (ping);
1956 ping_destroy (ping);
1959 exit (EXIT_SUCCESS);
1966 } /* }}} int main */
1968 /* vim: set fdm=marker : */