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 static char const * const hist_symbols_utf8[] = {
99 "▁", "▂", "▃", "▄", "▅", "▆", "▇", "█" };
100 static size_t const hist_symbols_utf8_num = sizeof (hist_symbols_utf8)
101 / sizeof (hist_symbols_utf8[0]);
103 /* scancodes for 6 levels of horizontal bars, ncurses-specific */
104 /* those are not the usual constants because those are not constant */
105 static int const hist_symbols_acs[] = {
106 115, /* ACS_S9 "⎽" */
107 114, /* ACS_S7 "⎼" */
108 113, /* ACS_S5 "─" */
109 112, /* ACS_S3 "⎻" */
112 static size_t const hist_symbols_acs_num = sizeof (hist_symbols_acs)
113 / sizeof (hist_symbols_acs[0]);
115 /* use different colors without a background for scancodes */
116 static int const hist_colors_utf8[] = {
117 OPING_GREEN_HIST, OPING_YELLOW_HIST, OPING_RED_HIST };
118 static int const hist_colors_acs[] = {
119 OPING_GREEN, OPING_YELLOW, OPING_RED };
120 /* assuming that both arrays are the same size */
121 static size_t const hist_colors_num = sizeof (hist_colors_utf8)
122 / sizeof (hist_colors_utf8[0]);
126 #define BOXPLOT_WHISKER_BAR (113 | A_ALTCHARSET)
128 #define BOXPLOT_WHISKER_LEFT_END (116 | A_ALTCHARSET)
130 #define BOXPLOT_WHISKER_RIGHT_END (117 | A_ALTCHARSET)
132 #define BOXPLOT_BOX ' '
134 #define BOXPLOT_MEDIAN (120 | A_ALTCHARSET)
138 #ifndef _POSIX_SAVED_IDS
139 # define _POSIX_SAVED_IDS 0
142 #ifndef IPTOS_MINCOST
143 # define IPTOS_MINCOST 0x02
146 /* Remove GNU specific __attribute__ settings when using another compiler */
148 # define __attribute__(x) /**/
151 typedef struct ping_context
153 char host[NI_MAXHOST];
154 char addr[NI_MAXHOST];
162 double latency_total;
163 double latency_total_square;
165 /* 1000 + one "infinity" bucket. */
166 #define OPING_HISTOGRAM_BUCKETS 1001
167 uint32_t *latency_histogram;
168 size_t latency_histogram_size;
175 static double opt_interval = 1.0;
176 static int opt_addrfamily = PING_DEF_AF;
177 static char *opt_srcaddr = NULL;
178 static char *opt_device = NULL;
179 static char *opt_filename = NULL;
180 static int opt_count = -1;
181 static int opt_send_ttl = 64;
182 static uint8_t opt_send_qos = 0;
183 #define OPING_DEFAULT_PERCENTILE 95.0
184 static double opt_percentile = -1.0;
185 static double opt_exit_status_threshold = 1.0;
187 static int opt_show_graph = 1;
188 static int opt_utf8 = 0;
191 static int host_num = 0;
194 static WINDOW *main_win = NULL;
197 static void sigint_handler (int signal) /* {{{ */
199 /* Make compiler happy */
203 } /* }}} void sigint_handler */
205 static ping_context_t *context_create (void) /* {{{ */
209 if ((ret = malloc (sizeof (ping_context_t))) == NULL)
212 memset (ret, '\0', sizeof (ping_context_t));
214 ret->latency_min = -1.0;
215 ret->latency_max = -1.0;
216 ret->latency_total = 0.0;
217 ret->latency_total_square = 0.0;
219 ret->latency_histogram_size = (size_t) OPING_HISTOGRAM_BUCKETS;
220 ret->latency_histogram = calloc (ret->latency_histogram_size,
221 sizeof (*ret->latency_histogram));
228 } /* }}} ping_context_t *context_create */
230 static void context_destroy (ping_context_t *context) /* {{{ */
236 if (context->window != NULL)
238 delwin (context->window);
239 context->window = NULL;
243 free (context->latency_histogram);
244 context->latency_histogram = NULL;
247 } /* }}} void context_destroy */
249 static double context_get_average (ping_context_t *ctx) /* {{{ */
256 if (ctx->req_rcvd < 1)
259 num_total = (double) ctx->req_rcvd;
260 return (ctx->latency_total / num_total);
261 } /* }}} double context_get_average */
263 static double context_get_percentile (ping_context_t *ctx, /* {{{ */
266 double threshold = percentile / 100.0;
267 uint32_t accumulated[ctx->latency_histogram_size];
268 double ratios[ctx->latency_histogram_size];
269 double index_to_ms_factor;
273 if (ctx->latency_histogram == NULL)
276 accumulated[0] = ctx->latency_histogram[0];
277 for (i = 1; i < ctx->latency_histogram_size; i++)
278 accumulated[i] = accumulated[i - 1]
279 + ctx->latency_histogram[i];
280 num = accumulated[ctx->latency_histogram_size - 1];
282 for (i = 0; i < ctx->latency_histogram_size; i++)
284 ratios[i] = ((double) accumulated[i]) / ((double) num);
285 if (ratios[i] >= threshold)
289 if (i >= ctx->latency_histogram_size)
291 else if (i == (ctx->latency_histogram_size - 1))
294 index_to_ms_factor = (1000.0 * opt_interval) / (ctx->latency_histogram_size - 1);
296 /* Multiply with i+1, because we're interested in the _upper_ bound of
298 return (index_to_ms_factor * ((double) (i + 1)));
299 } /* }}} double context_get_percentile */
301 static double context_get_stddev (ping_context_t *ctx) /* {{{ */
308 if (ctx->req_rcvd < 1)
310 else if (ctx->req_rcvd < 2)
313 num_total = (double) ctx->req_rcvd;
314 return (sqrt (((num_total * ctx->latency_total_square)
315 - (ctx->latency_total * ctx->latency_total))
316 / (num_total * (num_total - 1.0))));
317 } /* }}} double context_get_stddev */
319 static double context_get_packet_loss (const ping_context_t *ctx) /* {{{ */
324 if (ctx->req_sent < 1)
327 return (100.0 * (ctx->req_sent - ctx->req_rcvd)
328 / ((double) ctx->req_sent));
329 } /* }}} double context_get_packet_loss */
331 static int ping_initialize_contexts (pingobj_t *ping) /* {{{ */
333 pingobj_iter_t *iter;
340 for (iter = ping_iterator_get (ping);
342 iter = ping_iterator_next (iter))
344 ping_context_t *context;
347 context = context_create ();
348 context->index = index;
350 buffer_size = sizeof (context->host);
351 ping_iterator_get_info (iter, PING_INFO_HOSTNAME, context->host, &buffer_size);
353 buffer_size = sizeof (context->addr);
354 ping_iterator_get_info (iter, PING_INFO_ADDRESS, context->addr, &buffer_size);
356 ping_iterator_set_context (iter, (void *) context);
362 } /* }}} int ping_initialize_contexts */
364 static void usage_exit (const char *name, int status) /* {{{ */
366 fprintf (stderr, "Usage: %s [OPTIONS] "
367 "-f filename | host [host [host ...]]\n"
369 "\nAvailable options:\n"
370 " -4|-6 force the use of IPv4 or IPv6\n"
371 " -c count number of ICMP packets to send\n"
372 " -i interval interval with which to send ICMP packets\n"
373 " -t ttl time to live for each ICMP packet\n"
374 " -Q qos Quality of Service (QoS) of outgoing packets\n"
375 " Use \"-Q help\" for a list of valid options.\n"
376 " -I srcaddr source address\n"
377 " -D device outgoing interface name\n"
378 " -f filename filename to read hosts from\n"
380 " -u / -U force / disable UTF-8 output\n"
382 " -P percent Report the n'th percentile of latency\n"
383 " -Z percent Exit with non-zero exit status if more than this percentage of\n"
384 " probes timed out. (default: never)\n"
386 "\noping "PACKAGE_VERSION", http://verplant.org/liboping/\n"
387 "by Florian octo Forster <octo@verplant.org>\n"
388 "for contributions see `AUTHORS'\n",
391 } /* }}} void usage_exit */
393 __attribute__((noreturn))
394 static void usage_qos_exit (const char *arg, int status) /* {{{ */
397 fprintf (stderr, "Invalid QoS argument: \"%s\"\n\n", arg);
399 fprintf (stderr, "Valid QoS arguments (option \"-Q\") are:\n"
401 " Differentiated Services (IPv4 and IPv6, RFC 2474)\n"
403 " be Best Effort (BE, default PHB).\n"
404 " ef Expedited Forwarding (EF) PHB group (RFC 3246).\n"
405 " (low delay, low loss, low jitter)\n"
406 " va Voice Admit (VA) DSCP (RFC 5865).\n"
407 " (capacity-admitted traffic)\n"
408 " af[1-4][1-3] Assured Forwarding (AF) PHB group (RFC 2597).\n"
409 " For example: \"af12\" (class 1, precedence 2)\n"
410 " cs[0-7] Class Selector (CS) PHB group (RFC 2474).\n"
411 " For example: \"cs1\" (priority traffic)\n"
413 " Type of Service (IPv4, RFC 1349, obsolete)\n"
415 " lowdelay (%#04x) minimize delay\n"
416 " throughput (%#04x) maximize throughput\n"
417 " reliability (%#04x) maximize reliability\n"
418 " mincost (%#04x) minimize monetary cost\n"
420 " Specify manually\n"
422 " 0x00 - 0xff Hexadecimal numeric specification.\n"
423 " 0 - 255 Decimal numeric specification.\n"
425 (unsigned int) IPTOS_LOWDELAY,
426 (unsigned int) IPTOS_THROUGHPUT,
427 (unsigned int) IPTOS_RELIABILITY,
428 (unsigned int) IPTOS_MINCOST);
431 } /* }}} void usage_qos_exit */
433 static int set_opt_send_qos (const char *opt) /* {{{ */
438 if (strcasecmp ("help", opt) == 0)
439 usage_qos_exit (/* arg = */ NULL, /* status = */ EXIT_SUCCESS);
440 /* DiffServ (RFC 2474): */
441 /* - Best effort (BE) */
442 else if (strcasecmp ("be", opt) == 0)
444 /* - Expedited Forwarding (EF, RFC 3246) */
445 else if (strcasecmp ("ef", opt) == 0)
446 opt_send_qos = 0xB8; /* == 0x2E << 2 */
447 /* - Voice Admit (VA, RFC 5865) */
448 else if (strcasecmp ("va", opt) == 0)
449 opt_send_qos = 0xB0; /* == 0x2D << 2 */
450 /* - Assured Forwarding (AF, RFC 2597) */
451 else if ((strncasecmp ("af", opt, strlen ("af")) == 0)
452 && (strlen (opt) == 4))
458 /* There are four classes, AF1x, AF2x, AF3x, and AF4x. */
461 else if (opt[2] == '2')
463 else if (opt[2] == '3')
465 else if (opt[2] == '4')
468 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_SUCCESS);
470 /* In each class, there are three precedences, AFx1, AFx2, and AFx3 */
473 else if (opt[3] == '2')
475 else if (opt[3] == '3')
478 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_SUCCESS);
480 dscp = (8 * class) + (2 * prec);
481 /* The lower two bits are used for Explicit Congestion Notification (ECN) */
482 opt_send_qos = dscp << 2;
484 /* - Class Selector (CS) */
485 else if ((strncasecmp ("cs", opt, strlen ("cs")) == 0)
486 && (strlen (opt) == 3))
490 if ((opt[2] < '0') || (opt[2] > '7'))
491 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_FAILURE);
493 /* Not exactly legal by the C standard, but I don't know of any
494 * system not supporting this hack. */
495 class = ((uint8_t) opt[2]) - ((uint8_t) '0');
496 opt_send_qos = class << 5;
498 /* Type of Service (RFC 1349) */
499 else if (strcasecmp ("lowdelay", opt) == 0)
500 opt_send_qos = IPTOS_LOWDELAY;
501 else if (strcasecmp ("throughput", opt) == 0)
502 opt_send_qos = IPTOS_THROUGHPUT;
503 else if (strcasecmp ("reliability", opt) == 0)
504 opt_send_qos = IPTOS_RELIABILITY;
505 else if (strcasecmp ("mincost", opt) == 0)
506 opt_send_qos = IPTOS_MINCOST;
515 value = strtoul (opt, &endptr, /* base = */ 0);
516 if ((errno != 0) || (endptr == opt)
517 || (endptr == NULL) || (*endptr != 0)
519 usage_qos_exit (/* arg = */ opt, /* status = */ EXIT_FAILURE);
521 opt_send_qos = (uint8_t) value;
525 } /* }}} int set_opt_send_qos */
527 static char *format_qos (uint8_t qos, char *buffer, size_t buffer_size) /* {{{ */
539 case 0x00: dscp_str = "be"; break;
540 case 0x2e: dscp_str = "ef"; break;
541 case 0x2d: dscp_str = "va"; break;
542 case 0x0a: dscp_str = "af11"; break;
543 case 0x0c: dscp_str = "af12"; break;
544 case 0x0e: dscp_str = "af13"; break;
545 case 0x12: dscp_str = "af21"; break;
546 case 0x14: dscp_str = "af22"; break;
547 case 0x16: dscp_str = "af23"; break;
548 case 0x1a: dscp_str = "af31"; break;
549 case 0x1c: dscp_str = "af32"; break;
550 case 0x1e: dscp_str = "af33"; break;
551 case 0x22: dscp_str = "af41"; break;
552 case 0x24: dscp_str = "af42"; break;
553 case 0x26: dscp_str = "af43"; break;
554 case 0x08: dscp_str = "cs1"; break;
555 case 0x10: dscp_str = "cs2"; break;
556 case 0x18: dscp_str = "cs3"; break;
557 case 0x20: dscp_str = "cs4"; break;
558 case 0x28: dscp_str = "cs5"; break;
559 case 0x30: dscp_str = "cs6"; break;
560 case 0x38: dscp_str = "cs7"; break;
561 default: dscp_str = NULL;
566 case 0x01: ecn_str = ",ecn(1)"; break;
567 case 0x02: ecn_str = ",ecn(0)"; break;
568 case 0x03: ecn_str = ",ce"; break;
569 default: ecn_str = "";
572 if (dscp_str == NULL)
573 snprintf (buffer, buffer_size, "0x%02x%s", dscp, ecn_str);
575 snprintf (buffer, buffer_size, "%s%s", dscp_str, ecn_str);
576 buffer[buffer_size - 1] = 0;
579 } /* }}} char *format_qos */
581 static int read_options (int argc, char **argv) /* {{{ */
587 optchar = getopt (argc, argv, "46c:hi:I:t:Q:f:D:Z:P:"
600 opt_addrfamily = (optchar == '4') ? AF_INET : AF_INET6;
606 new_count = atoi (optarg);
609 opt_count = new_count;
611 if ((opt_percentile < 0.0) && (opt_count < 20))
612 opt_percentile = 100.0 * (opt_count - 1) / opt_count;
615 fprintf(stderr, "Ignoring invalid count: %s\n",
622 if (opt_filename != NULL)
624 opt_filename = strdup (optarg);
631 new_interval = atof (optarg);
632 if (new_interval < 0.001)
633 fprintf (stderr, "Ignoring invalid interval: %s\n",
636 opt_interval = new_interval;
642 if (opt_srcaddr != NULL)
644 opt_srcaddr = strdup (optarg);
655 new_send_ttl = atoi (optarg);
656 if ((new_send_ttl > 0) && (new_send_ttl < 256))
657 opt_send_ttl = new_send_ttl;
659 fprintf (stderr, "Ignoring invalid TTL argument: %s\n",
665 set_opt_send_qos (optarg);
670 double new_percentile;
671 new_percentile = atof (optarg);
672 if (isnan (new_percentile)
673 || (new_percentile < 0.1)
674 || (new_percentile > 100.0))
675 fprintf (stderr, "Ignoring invalid percentile: %s\n",
678 opt_percentile = new_percentile;
684 if (strcasecmp ("none", optarg) == 0)
686 else if (strcasecmp ("prettyping", optarg) == 0)
688 else if (strcasecmp ("boxplot", optarg) == 0)
691 fprintf (stderr, "Unknown graph option: %s\n", optarg);
708 tmp = strtod (optarg, &endptr);
709 if ((errno != 0) || (endptr == NULL) || (*endptr != 0) || (tmp < 0.0) || (tmp > 100.0))
711 fprintf (stderr, "Ignoring invalid -Z argument: %s\n", optarg);
712 fprintf (stderr, "The \"-Z\" option requires a numeric argument between 0 and 100.\n");
715 opt_exit_status_threshold = tmp / 100.0;
721 usage_exit (argv[0], 0);
725 usage_exit (argv[0], 1);
729 if (opt_percentile <= 0.0)
730 opt_percentile = OPING_DEFAULT_PERCENTILE;
733 } /* }}} read_options */
735 static void time_normalize (struct timespec *ts) /* {{{ */
737 while (ts->tv_nsec < 0)
746 ts->tv_nsec += 1000000000;
749 while (ts->tv_nsec >= 1000000000)
752 ts->tv_nsec -= 1000000000;
754 } /* }}} void time_normalize */
756 static void time_calc (struct timespec *ts_dest, /* {{{ */
757 const struct timespec *ts_int,
758 const struct timeval *tv_begin,
759 const struct timeval *tv_end)
761 ts_dest->tv_sec = tv_begin->tv_sec + ts_int->tv_sec;
762 ts_dest->tv_nsec = (tv_begin->tv_usec * 1000) + ts_int->tv_nsec;
763 time_normalize (ts_dest);
765 /* Assure that `(begin + interval) > end'.
766 * This may seem overly complicated, but `tv_sec' is of type `time_t'
767 * which may be `unsigned. *sigh* */
768 if ((tv_end->tv_sec > ts_dest->tv_sec)
769 || ((tv_end->tv_sec == ts_dest->tv_sec)
770 && ((tv_end->tv_usec * 1000) > ts_dest->tv_nsec)))
773 ts_dest->tv_nsec = 0;
777 ts_dest->tv_sec = ts_dest->tv_sec - tv_end->tv_sec;
778 ts_dest->tv_nsec = ts_dest->tv_nsec - (tv_end->tv_usec * 1000);
779 time_normalize (ts_dest);
780 } /* }}} void time_calc */
783 static _Bool has_utf8() /* {{{ */
785 # if HAVE_NCURSESW_NCURSES_H
788 /* Automatically determine */
789 if (strcasecmp ("UTF-8", nl_langinfo (CODESET)) == 0)
794 return ((_Bool) (opt_utf8 - 1));
798 } /* }}} _Bool has_utf8 */
800 static int update_boxplot (ping_context_t *ctx) /* {{{ */
802 uint32_t *accumulated;
809 x_max = (size_t) getmaxx (ctx->window);
814 accumulated = calloc (x_max, sizeof (*accumulated));
815 ratios = calloc (x_max, sizeof (*ratios));
818 for (i = 0; i < ctx->latency_histogram_size; i++)
820 x = i * x_max / ctx->latency_histogram_size;
821 accumulated[x] += ctx->latency_histogram[i];
825 for (x = 1; x < x_max; x++)
826 accumulated[x] += accumulated[x - 1];
828 num = accumulated[x_max - 1];
830 /* Calculate ratios */
831 for (x = 0; x < x_max; x++)
832 ratios[x] = ((double) accumulated[x]) / ((double) num);
834 for (x = 0; x < x_max; x++)
841 if (ratios[x] >= 0.5)
843 symbol = BOXPLOT_MEDIAN;
846 else if (ratios[x] > 0.25)
848 symbol = BOXPLOT_BOX;
851 else if (ratios[x] > 0.025)
852 symbol = BOXPLOT_WHISKER_BAR;
854 symbol = ' '; /* NOP */
858 if ((ratios[x - 1] < 0.5) && (ratios[x] >= 0.5))
860 symbol = BOXPLOT_MEDIAN;
863 else if (((ratios[x] >= 0.25) && (ratios[x] <= 0.75))
864 || ((ratios[x - 1] < 0.75) && (ratios[x] > 0.75)))
866 symbol = BOXPLOT_BOX;
869 else if ((ratios[x] < 0.5) && (ratios[x] >= 0.025))
871 if (ratios[x - 1] < 0.025)
872 symbol = BOXPLOT_WHISKER_LEFT_END;
874 symbol = BOXPLOT_WHISKER_BAR;
876 else if ((ratios[x] > .5) && (ratios[x] < 0.975))
878 symbol = BOXPLOT_WHISKER_BAR;
880 else if ((ratios[x] >= 0.975) && (ratios[x - 1] < 0.975))
881 symbol = BOXPLOT_WHISKER_RIGHT_END;
885 wattron (ctx->window, A_REVERSE);
886 mvwaddch (ctx->window, /* y = */ 3, /* x = */ (int) (x + 2), symbol);
887 // mvwprintw (ctx->window, /* y = */ 3, /* x = */ (int) (x + 2), symbol);
889 wattroff (ctx->window, A_REVERSE);
895 } /* }}} int update_boxplot */
897 static int update_prettyping_graph (ping_context_t *ctx, /* {{{ */
898 double latency, unsigned int sequence)
900 int color = OPING_RED;
901 char const *symbol = "!";
907 x_max = getmaxx (ctx->window);
908 x_pos = ((sequence - 1) % (x_max - 4)) + 2;
914 size_t symbols_num = hist_symbols_acs_num;
915 size_t colors_num = 1;
917 size_t index_symbols;
921 /* latency is in milliseconds, opt_interval is in seconds. */
922 ratio = (latency * 0.001) / opt_interval;
928 symbols_num = hist_symbols_utf8_num;
930 if (has_colors () == TRUE)
931 colors_num = hist_colors_num;
933 intensity = (size_t) (ratio * ((double) (symbols_num * colors_num)));
934 if (intensity >= (symbols_num * colors_num))
935 intensity = (symbols_num * colors_num) - 1;
937 index_symbols = intensity % symbols_num;
938 assert (index_symbols < symbols_num);
940 index_colors = intensity / symbols_num;
941 assert (index_colors < colors_num);
945 color = hist_colors_utf8[index_colors];
946 symbol = hist_symbols_utf8[index_symbols];
950 color = hist_colors_acs[index_colors];
951 symbolc = hist_symbols_acs[index_symbols] | A_ALTCHARSET;
954 else /* if (!(latency >= 0.0)) */
955 wattron (ctx->window, A_BOLD);
957 if (has_colors () == TRUE)
958 wattron (ctx->window, COLOR_PAIR(color));
961 mvwprintw (ctx->window, /* y = */ 3, /* x = */ x_pos, symbol);
963 mvwaddch (ctx->window, /* y = */ 3, /* x = */ x_pos, symbolc);
965 if (has_colors () == TRUE)
966 wattroff (ctx->window, COLOR_PAIR(color));
968 /* Use negation here to handle NaN correctly. */
969 if (!(latency >= 0.0))
970 wattroff (ctx->window, A_BOLD);
972 wprintw (ctx->window, " ");
974 } /* }}} int update_prettyping_graph */
976 static int update_stats_from_context (ping_context_t *ctx, pingobj_iter_t *iter) /* {{{ */
978 double latency = -1.0;
979 size_t buffer_len = sizeof (latency);
981 ping_iterator_get_info (iter, PING_INFO_LATENCY,
982 &latency, &buffer_len);
984 unsigned int sequence = 0;
985 buffer_len = sizeof (sequence);
986 ping_iterator_get_info (iter, PING_INFO_SEQUENCE,
987 &sequence, &buffer_len);
990 if ((ctx == NULL) || (ctx->window == NULL))
993 /* werase (ctx->window); */
995 box (ctx->window, 0, 0);
996 wattron (ctx->window, A_BOLD);
997 mvwprintw (ctx->window, /* y = */ 0, /* x = */ 5,
999 wattroff (ctx->window, A_BOLD);
1000 wprintw (ctx->window, "ping statistics ");
1001 mvwprintw (ctx->window, /* y = */ 1, /* x = */ 2,
1002 "%i packets transmitted, %i received, %.2f%% packet "
1003 "loss, time %.1fms",
1004 ctx->req_sent, ctx->req_rcvd,
1005 context_get_packet_loss (ctx),
1006 ctx->latency_total);
1007 if (ctx->req_rcvd != 0)
1013 average = context_get_average (ctx);
1014 deviation = context_get_stddev (ctx);
1015 percentile = context_get_percentile (ctx, opt_percentile);
1017 mvwprintw (ctx->window, /* y = */ 2, /* x = */ 2,
1018 "rtt min/avg/%.0f%%/max/sdev = "
1019 "%.3f/%.3f/%.0f/%.3f/%.3f ms\n",
1028 if (opt_show_graph == 1)
1029 update_prettyping_graph (ctx, latency, sequence);
1030 else if (opt_show_graph == 2)
1031 update_boxplot (ctx);
1033 wrefresh (ctx->window);
1036 } /* }}} int update_stats_from_context */
1038 static int on_resize (pingobj_t *ping) /* {{{ */
1040 pingobj_iter_t *iter;
1043 int main_win_height;
1044 int box_height = (opt_show_graph == 0) ? 4 : 5;
1046 getmaxyx (stdscr, height, width);
1047 if ((height < 1) || (width < 1))
1050 main_win_height = height - (box_height * host_num);
1051 wresize (main_win, main_win_height, /* width = */ width);
1052 /* Allow scrolling */
1053 scrollok (main_win, TRUE);
1054 /* wsetscrreg (main_win, 0, main_win_height - 1); */
1055 /* Allow hardware accelerated scrolling. */
1056 idlok (main_win, TRUE);
1057 wrefresh (main_win);
1059 for (iter = ping_iterator_get (ping);
1061 iter = ping_iterator_next (iter))
1063 ping_context_t *context;
1065 context = ping_iterator_get_context (iter);
1066 if (context == NULL)
1069 if (context->window != NULL)
1071 delwin (context->window);
1072 context->window = NULL;
1074 context->window = newwin (/* height = */ box_height,
1075 /* width = */ width,
1076 /* y = */ main_win_height + (box_height * context->index),
1083 static int check_resize (pingobj_t *ping) /* {{{ */
1085 int need_resize = 0;
1089 int key = wgetch (stdscr);
1092 else if (key == KEY_RESIZE)
1097 return (on_resize (ping));
1100 } /* }}} int check_resize */
1102 static int pre_loop_hook (pingobj_t *ping) /* {{{ */
1104 pingobj_iter_t *iter;
1107 int main_win_height;
1108 int box_height = (opt_show_graph == 0) ? 4 : 5;
1113 nodelay (stdscr, TRUE);
1115 getmaxyx (stdscr, height, width);
1116 if ((height < 1) || (width < 1))
1119 if (has_colors () == TRUE)
1122 init_pair (OPING_GREEN, COLOR_GREEN, /* default = */ 0);
1123 init_pair (OPING_YELLOW, COLOR_YELLOW, /* default = */ 0);
1124 init_pair (OPING_RED, COLOR_RED, /* default = */ 0);
1125 init_pair (OPING_GREEN_HIST, COLOR_GREEN, COLOR_BLACK);
1126 init_pair (OPING_YELLOW_HIST, COLOR_YELLOW, COLOR_GREEN);
1127 init_pair (OPING_RED_HIST, COLOR_RED, COLOR_YELLOW);
1130 main_win_height = height - (box_height * host_num);
1131 main_win = newwin (/* height = */ main_win_height,
1132 /* width = */ width,
1133 /* y = */ 0, /* x = */ 0);
1134 /* Allow scrolling */
1135 scrollok (main_win, TRUE);
1136 /* wsetscrreg (main_win, 0, main_win_height - 1); */
1137 /* Allow hardware accelerated scrolling. */
1138 idlok (main_win, TRUE);
1139 wmove (main_win, /* y = */ main_win_height - 1, /* x = */ 0);
1140 wrefresh (main_win);
1142 for (iter = ping_iterator_get (ping);
1144 iter = ping_iterator_next (iter))
1146 ping_context_t *context;
1148 context = ping_iterator_get_context (iter);
1149 if (context == NULL)
1152 if (context->window != NULL)
1154 delwin (context->window);
1155 context->window = NULL;
1157 context->window = newwin (/* height = */ box_height,
1158 /* width = */ width,
1159 /* y = */ main_win_height + (box_height * context->index),
1164 /* Don't know what good this does exactly, but without this code
1165 * "check_resize" will be called right after startup and *somehow*
1166 * this leads to display errors. If we purge all initial characters
1167 * here, the problem goes away. "wgetch" is non-blocking due to
1168 * "nodelay" (see above). */
1169 while (wgetch (stdscr) != ERR)
1171 /* eat up characters */;
1175 } /* }}} int pre_loop_hook */
1177 static int pre_sleep_hook (pingobj_t *ping) /* {{{ */
1179 return (check_resize (ping));
1180 } /* }}} int pre_sleep_hook */
1182 static int post_sleep_hook (pingobj_t *ping) /* {{{ */
1184 return (check_resize (ping));
1185 } /* }}} int pre_sleep_hook */
1186 #else /* if !USE_NCURSES */
1187 static int pre_loop_hook (pingobj_t *ping) /* {{{ */
1189 pingobj_iter_t *iter;
1191 for (iter = ping_iterator_get (ping);
1193 iter = ping_iterator_next (iter))
1195 ping_context_t *ctx;
1198 ctx = ping_iterator_get_context (iter);
1203 ping_iterator_get_info (iter, PING_INFO_DATA, NULL, &buffer_size);
1205 printf ("PING %s (%s) %zu bytes of data.\n",
1206 ctx->host, ctx->addr, buffer_size);
1210 } /* }}} int pre_loop_hook */
1212 static int pre_sleep_hook (__attribute__((unused)) pingobj_t *ping) /* {{{ */
1217 } /* }}} int pre_sleep_hook */
1219 static int post_sleep_hook (__attribute__((unused)) pingobj_t *ping) /* {{{ */
1222 } /* }}} int post_sleep_hook */
1225 static void update_context (ping_context_t *context, double latency) /* {{{ */
1229 context->req_rcvd++;
1230 context->latency_total += latency;
1231 context->latency_total_square += (latency * latency);
1233 if ((context->latency_max < 0.0) || (context->latency_max < latency))
1234 context->latency_max = latency;
1235 if ((context->latency_min < 0.0) || (context->latency_min > latency))
1236 context->latency_min = latency;
1238 if (context->latency_histogram == NULL)
1241 /* latency is in ms, opt_interval is in s. */
1242 bucket = (size_t) ((latency * (context->latency_histogram_size - 1))
1243 / (1000.0 * opt_interval));
1244 if (bucket >= context->latency_histogram_size)
1245 bucket = context->latency_histogram_size - 1;
1246 context->latency_histogram[bucket]++;
1247 } /* }}} void update_context */
1249 static void update_host_hook (pingobj_iter_t *iter, /* {{{ */
1250 __attribute__((unused)) int index)
1253 unsigned int sequence;
1256 char recv_qos_str[16];
1259 ping_context_t *context;
1262 buffer_len = sizeof (latency);
1263 ping_iterator_get_info (iter, PING_INFO_LATENCY,
1264 &latency, &buffer_len);
1267 buffer_len = sizeof (sequence);
1268 ping_iterator_get_info (iter, PING_INFO_SEQUENCE,
1269 &sequence, &buffer_len);
1272 buffer_len = sizeof (recv_ttl);
1273 ping_iterator_get_info (iter, PING_INFO_RECV_TTL,
1274 &recv_ttl, &buffer_len);
1277 buffer_len = sizeof (recv_qos);
1278 ping_iterator_get_info (iter, PING_INFO_RECV_QOS,
1279 &recv_qos, &buffer_len);
1282 ping_iterator_get_info (iter, PING_INFO_DATA,
1285 context = (ping_context_t *) ping_iterator_get_context (iter);
1288 # define HOST_PRINTF(...) wprintw(main_win, __VA_ARGS__)
1290 # define HOST_PRINTF(...) printf(__VA_ARGS__)
1293 context->req_sent++;
1296 update_context (context, latency);
1299 if (has_colors () == TRUE)
1301 int color = OPING_GREEN;
1302 double average = context_get_average (context);
1303 double stddev = context_get_stddev (context);
1305 if ((latency < (average - (2 * stddev)))
1306 || (latency > (average + (2 * stddev))))
1308 else if ((latency < (average - stddev))
1309 || (latency > (average + stddev)))
1310 color = OPING_YELLOW;
1312 HOST_PRINTF ("%zu bytes from %s (%s): icmp_seq=%u ttl=%i ",
1313 data_len, context->host, context->addr,
1315 format_qos (recv_qos, recv_qos_str, sizeof (recv_qos_str)));
1316 if ((recv_qos != 0) || (opt_send_qos != 0))
1318 HOST_PRINTF ("qos=%s ",
1319 format_qos (recv_qos, recv_qos_str, sizeof (recv_qos_str)));
1321 HOST_PRINTF ("time=");
1322 wattron (main_win, COLOR_PAIR(color));
1323 HOST_PRINTF ("%.2f", latency);
1324 wattroff (main_win, COLOR_PAIR(color));
1325 HOST_PRINTF (" ms\n");
1330 HOST_PRINTF ("%zu bytes from %s (%s): icmp_seq=%u ttl=%i ",
1332 context->host, context->addr,
1333 sequence, recv_ttl);
1334 if ((recv_qos != 0) || (opt_send_qos != 0))
1336 HOST_PRINTF ("qos=%s ",
1337 format_qos (recv_qos, recv_qos_str, sizeof (recv_qos_str)));
1339 HOST_PRINTF ("time=%.2f ms\n", latency);
1347 if (has_colors () == TRUE)
1349 HOST_PRINTF ("echo reply from %s (%s): icmp_seq=%u ",
1350 context->host, context->addr,
1352 wattron (main_win, COLOR_PAIR(OPING_RED) | A_BOLD);
1353 HOST_PRINTF ("timeout");
1354 wattroff (main_win, COLOR_PAIR(OPING_RED) | A_BOLD);
1360 HOST_PRINTF ("echo reply from %s (%s): icmp_seq=%u timeout\n",
1361 context->host, context->addr,
1369 update_stats_from_context (context, iter);
1370 wrefresh (main_win);
1372 } /* }}} void update_host_hook */
1374 /* Prints statistics for each host, cleans up the contexts and returns the
1375 * number of hosts which failed to return more than the fraction
1376 * opt_exit_status_threshold of pings. */
1377 static int post_loop_hook (pingobj_t *ping) /* {{{ */
1379 pingobj_iter_t *iter;
1380 int failure_count = 0;
1386 for (iter = ping_iterator_get (ping);
1388 iter = ping_iterator_next (iter))
1390 ping_context_t *context;
1392 context = ping_iterator_get_context (iter);
1394 printf ("\n--- %s ping statistics ---\n"
1395 "%i packets transmitted, %i received, %.2f%% packet loss, time %.1fms\n",
1396 context->host, context->req_sent, context->req_rcvd,
1397 context_get_packet_loss (context),
1398 context->latency_total);
1401 double pct_failed = 1.0 - (((double) context->req_rcvd)
1402 / ((double) context->req_sent));
1403 if (pct_failed > opt_exit_status_threshold)
1407 if (context->req_rcvd != 0)
1413 average = context_get_average (context);
1414 deviation = context_get_stddev (context);
1415 percentile = context_get_percentile (context, opt_percentile);
1417 printf ("rtt min/avg/%.0f%%/max/sdev = "
1418 "%.3f/%.3f/%.0f/%.3f/%.3f ms\n",
1420 context->latency_min,
1423 context->latency_max,
1427 ping_iterator_set_context (iter, NULL);
1428 context_destroy (context);
1431 return (failure_count);
1432 } /* }}} int post_loop_hook */
1434 int main (int argc, char **argv) /* {{{ */
1437 pingobj_iter_t *iter;
1439 struct sigaction sigint_action;
1441 struct timeval tv_begin;
1442 struct timeval tv_end;
1443 struct timespec ts_wait;
1444 struct timespec ts_int;
1449 #if _POSIX_SAVED_IDS
1450 uid_t saved_set_uid;
1452 /* Save the old effective user id */
1453 saved_set_uid = geteuid ();
1454 /* Set the effective user ID to the real user ID without changing the
1455 * saved set-user ID */
1456 status = seteuid (getuid ());
1459 fprintf (stderr, "Temporarily dropping privileges "
1460 "failed: %s\n", strerror (errno));
1461 exit (EXIT_FAILURE);
1465 setlocale(LC_ALL, "");
1466 optind = read_options (argc, argv);
1468 #if !_POSIX_SAVED_IDS
1469 /* Cannot temporarily drop privileges -> reject every file but "-". */
1470 if ((opt_filename != NULL)
1471 && (strcmp ("-", opt_filename) != 0)
1472 && (getuid () != geteuid ()))
1474 fprintf (stderr, "Your real and effective user IDs don't "
1475 "match. Reading from a file (option '-f')\n"
1476 "is therefore too risky. You can still read "
1477 "from STDIN using '-f -' if you like.\n"
1479 exit (EXIT_FAILURE);
1483 if ((optind >= argc) && (opt_filename == NULL)) {
1484 usage_exit (argv[0], 1);
1487 if ((ping = ping_construct ()) == NULL)
1489 fprintf (stderr, "ping_construct failed\n");
1493 if (ping_setopt (ping, PING_OPT_TTL, &opt_send_ttl) != 0)
1495 fprintf (stderr, "Setting TTL to %i failed: %s\n",
1496 opt_send_ttl, ping_get_error (ping));
1499 if (ping_setopt (ping, PING_OPT_QOS, &opt_send_qos) != 0)
1501 fprintf (stderr, "Setting TOS to %i failed: %s\n",
1502 opt_send_qos, ping_get_error (ping));
1509 temp_nsec = modf (opt_interval, &temp_sec);
1510 ts_int.tv_sec = (time_t) temp_sec;
1511 ts_int.tv_nsec = (long) (temp_nsec * 1000000000L);
1513 /* printf ("ts_int = %i.%09li\n", (int) ts_int.tv_sec, ts_int.tv_nsec); */
1516 if (opt_addrfamily != PING_DEF_AF)
1517 ping_setopt (ping, PING_OPT_AF, (void *) &opt_addrfamily);
1519 if (opt_srcaddr != NULL)
1521 if (ping_setopt (ping, PING_OPT_SOURCE, (void *) opt_srcaddr) != 0)
1523 fprintf (stderr, "Setting source address failed: %s\n",
1524 ping_get_error (ping));
1528 if (opt_device != NULL)
1530 if (ping_setopt (ping, PING_OPT_DEVICE, (void *) opt_device) != 0)
1532 fprintf (stderr, "Setting device failed: %s\n",
1533 ping_get_error (ping));
1537 if (opt_filename != NULL)
1543 if (strcmp (opt_filename, "-") == 0)
1545 infile = fdopen(0, "r");
1547 infile = fopen(opt_filename, "r");
1551 fprintf (stderr, "Opening %s failed: %s\n",
1552 (strcmp (opt_filename, "-") == 0)
1553 ? "STDIN" : opt_filename,
1558 #if _POSIX_SAVED_IDS
1559 /* Regain privileges */
1560 status = seteuid (saved_set_uid);
1563 fprintf (stderr, "Temporarily re-gaining privileges "
1564 "failed: %s\n", strerror (errno));
1565 exit (EXIT_FAILURE);
1569 while (fgets(line, sizeof(line), infile))
1571 /* Strip whitespace */
1572 if (sscanf(line, "%s", host) != 1)
1575 if ((host[0] == 0) || (host[0] == '#'))
1578 if (ping_host_add(ping, host) < 0)
1580 const char *errmsg = ping_get_error (ping);
1582 fprintf (stderr, "Adding host `%s' failed: %s\n", host, errmsg);
1591 #if _POSIX_SAVED_IDS
1592 /* Drop privileges */
1593 status = seteuid (getuid ());
1596 fprintf (stderr, "Temporarily dropping privileges "
1597 "failed: %s\n", strerror (errno));
1598 exit (EXIT_FAILURE);
1605 #if _POSIX_SAVED_IDS
1606 /* Regain privileges */
1607 status = seteuid (saved_set_uid);
1610 fprintf (stderr, "Temporarily re-gaining privileges "
1611 "failed: %s\n", strerror (errno));
1612 exit (EXIT_FAILURE);
1616 for (i = optind; i < argc; i++)
1618 if (ping_host_add (ping, argv[i]) < 0)
1620 const char *errmsg = ping_get_error (ping);
1622 fprintf (stderr, "Adding host `%s' failed: %s\n", argv[i], errmsg);
1631 /* Permanently drop root privileges if we're setuid-root. */
1632 status = setuid (getuid ());
1635 fprintf (stderr, "Dropping privileges failed: %s\n",
1637 exit (EXIT_FAILURE);
1640 #if _POSIX_SAVED_IDS
1641 saved_set_uid = (uid_t) -1;
1644 ping_initialize_contexts (ping);
1649 memset (&sigint_action, '\0', sizeof (sigint_action));
1650 sigint_action.sa_handler = sigint_handler;
1651 if (sigaction (SIGINT, &sigint_action, NULL) < 0)
1653 perror ("sigaction");
1657 pre_loop_hook (ping);
1659 while (opt_count != 0)
1664 if (gettimeofday (&tv_begin, NULL) < 0)
1666 perror ("gettimeofday");
1670 status = ping_send (ping);
1671 if (status == -EINTR)
1675 else if (status < 0)
1677 fprintf (stderr, "ping_send failed: %s\n",
1678 ping_get_error (ping));
1683 for (iter = ping_iterator_get (ping);
1685 iter = ping_iterator_next (iter))
1687 update_host_hook (iter, index);
1691 pre_sleep_hook (ping);
1693 /* Don't sleep in the last iteration */
1697 if (gettimeofday (&tv_end, NULL) < 0)
1699 perror ("gettimeofday");
1703 time_calc (&ts_wait, &ts_int, &tv_begin, &tv_end);
1705 /* printf ("Sleeping for %i.%09li seconds\n", (int) ts_wait.tv_sec, ts_wait.tv_nsec); */
1706 while ((status = nanosleep (&ts_wait, &ts_wait)) != 0)
1714 perror ("nanosleep");
1719 post_sleep_hook (ping);
1723 } /* while (opt_count != 0) */
1725 /* Returns the number of failed hosts according to -Z. */
1726 status = post_loop_hook (ping);
1728 ping_destroy (ping);
1731 exit (EXIT_SUCCESS);
1738 } /* }}} int main */
1740 /* vim: set fdm=marker : */