2 * Object oriented C module to send ICMP and ICMPv6 `echo's.
3 * Copyright (C) 2006-2011 Florian octo Forster <ff at octo.it>
5 * This library is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU Lesser General Public License as published by the
7 * Free Software Foundation; either version 2.1 of the License, or (at your
8 * option) any later version.
10 * This library is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
15 * You should have received a copy of the GNU Lesser General Public License
16 * along with this library; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 #define __APPLE_USE_RFC_3542
32 # include <inttypes.h>
36 # error "You don't have the standard C99 header files installed"
37 #endif /* STDC_HEADERS */
51 # include <sys/types.h>
54 # include <sys/stat.h>
57 #if TIME_WITH_SYS_TIME
58 # include <sys/time.h>
62 # include <sys/time.h>
69 # include <sys/socket.h>
76 #if HAVE_NETINET_IN_SYSTM_H
77 # include <netinet/in_systm.h>
80 # include <netinet/in.h>
83 # include <netinet/ip.h>
85 #if HAVE_NETINET_IP_ICMP_H
86 # include <netinet/ip_icmp.h>
88 #ifdef HAVE_NETINET_IP_VAR_H
89 # include <netinet/ip_var.h>
91 #if HAVE_NETINET_IP6_H
92 # include <netinet/ip6.h>
94 #if HAVE_NETINET_ICMP6_H
95 # include <netinet/icmp6.h>
101 # define dprintf(...) printf ("%s[%4i]: %-20s: ", __FILE__, __LINE__, __FUNCTION__); printf (__VA_ARGS__)
103 # define dprintf(...) /**/
106 #define PING_ERRMSG_LEN 256
110 /* username: name passed in by the user */
112 /* hostname: name returned by the reverse lookup */
114 struct sockaddr_storage *addr;
120 struct timeval *timer;
129 struct pinghost *next;
140 struct sockaddr *srcaddr;
141 socklen_t srcaddrlen;
145 char errmsg[PING_ERRMSG_LEN];
151 * private (static) functions
153 /* Even though Posix requires "strerror_r" to return an "int",
154 * some systems (e.g. the GNU libc) return a "char *" _and_
155 * ignore the second argument ... -tokkee */
156 static char *sstrerror (int errnum, char *buf, size_t buflen)
162 snprintf (buf, buflen, "Error %i (%#x)", errnum, errnum);
164 /* #endif !HAVE_STRERROR_R */
166 #elif STRERROR_R_CHAR_P
169 temp = strerror_r (errnum, buf, buflen);
172 if ((temp != NULL) && (temp != buf) && (temp[0] != 0))
173 strncpy (buf, temp, buflen);
175 strncpy (buf, "strerror_r did not return "
176 "an error message", buflen);
179 /* #endif STRERROR_R_CHAR_P */
182 if (strerror_r (errnum, buf, buflen) != 0)
184 snprintf (buf, buflen, "Error %i (%#x); "
185 "Additionally, strerror_r failed.",
188 #endif /* STRERROR_R_CHAR_P */
193 } /* char *sstrerror */
195 static void ping_set_error (pingobj_t *obj, const char *function,
198 snprintf (obj->errmsg, sizeof (obj->errmsg),
199 "%s: %s", function, message);
200 obj->errmsg[sizeof (obj->errmsg) - 1] = 0;
203 static void ping_set_errno (pingobj_t *obj, int error_number)
205 sstrerror (error_number, obj->errmsg, sizeof (obj->errmsg));
208 static int ping_timeval_add (struct timeval *tv1, struct timeval *tv2,
211 res->tv_sec = tv1->tv_sec + tv2->tv_sec;
212 res->tv_usec = tv1->tv_usec + tv2->tv_usec;
214 while (res->tv_usec > 1000000)
216 res->tv_usec -= 1000000;
223 static int ping_timeval_sub (struct timeval *tv1, struct timeval *tv2,
226 if ((tv1->tv_sec < tv2->tv_sec)
227 || ((tv1->tv_sec == tv2->tv_sec)
228 && (tv1->tv_usec < tv2->tv_usec)))
231 res->tv_sec = tv1->tv_sec - tv2->tv_sec;
232 res->tv_usec = tv1->tv_usec - tv2->tv_usec;
234 assert ((res->tv_sec > 0) || ((res->tv_sec == 0) && (res->tv_usec >= 0)));
236 while (res->tv_usec < 0)
238 res->tv_usec += 1000000;
245 static uint16_t ping_icmp4_checksum (char *buf, size_t len)
252 for (ptr = (uint16_t *) buf; len > 1; ptr++, len -= 2)
257 *(char *) &ret = *(char *) ptr;
261 /* Do this twice to get all possible carries.. */
262 sum = (sum >> 16) + (sum & 0xFFFF);
263 sum = (sum >> 16) + (sum & 0xFFFF);
270 static pinghost_t *ping_receive_ipv4 (pingobj_t *obj, char *buffer,
274 struct icmp *icmp_hdr;
278 uint16_t recv_checksum;
279 uint16_t calc_checksum;
286 if (buffer_len < sizeof (struct ip))
289 ip_hdr = (struct ip *) buffer;
290 ip_hdr_len = ip_hdr->ip_hl << 2;
292 if (buffer_len < ip_hdr_len)
295 buffer += ip_hdr_len;
296 buffer_len -= ip_hdr_len;
298 if (buffer_len < sizeof (struct icmp))
301 icmp_hdr = (struct icmp *) buffer;
302 buffer += sizeof (struct icmp);
303 buffer_len -= sizeof (struct icmp);
305 if (icmp_hdr->icmp_type != ICMP_ECHOREPLY)
307 dprintf ("Unexpected ICMP type: %i\n", icmp_hdr->icmp_type);
311 recv_checksum = icmp_hdr->icmp_cksum;
312 icmp_hdr->icmp_cksum = 0;
313 calc_checksum = ping_icmp4_checksum ((char *) icmp_hdr,
314 sizeof (struct icmp) + buffer_len);
316 if (recv_checksum != calc_checksum)
318 dprintf ("Checksum missmatch: Got 0x%04"PRIx16", "
319 "calculated 0x%04"PRIx16"\n",
320 recv_checksum, calc_checksum);
324 ident = ntohs (icmp_hdr->icmp_id);
325 seq = ntohs (icmp_hdr->icmp_seq);
327 /* We have to iterate over all hosts, since ICMPv4 packets may
328 * be received on any raw v4 socket. */
329 for (ptr = obj->head; ptr != NULL; ptr = ptr->next)
331 dprintf ("hostname = %s, ident = 0x%04x, seq = %i\n",
332 ptr->hostname, ptr->ident, ((ptr->sequence - 1) & 0xFFFF));
334 if (ptr->addrfamily != AF_INET)
337 if (!timerisset (ptr->timer))
340 if (ptr->ident != ident)
343 if (((ptr->sequence - 1) & 0xFFFF) != seq)
346 dprintf ("Match found: hostname = %s, ident = 0x%04"PRIx16", "
348 ptr->hostname, ident, seq);
355 dprintf ("No match found for ident = 0x%04"PRIx16", seq = %"PRIu16"\n",
360 ptr->recv_ttl = (int) ip_hdr->ip_ttl;
361 ptr->recv_qos = (uint8_t) ip_hdr->ip_tos;
366 #ifndef ICMP6_ECHO_REQUEST
367 # ifdef ICMP6_ECHO /* AIX netinet/ip6_icmp.h */
368 # define ICMP6_ECHO_REQUEST ICMP6_ECHO
370 # define ICMP6_ECHO_REQUEST 128
374 #ifndef ICMP6_ECHO_REPLY
375 # ifdef ICMP6_ECHOREPLY /* AIX netinet/ip6_icmp.h */
376 # define ICMP6_ECHO_REPLY ICMP6_ECHOREPLY
378 # define ICMP6_ECHO_REPLY 129
382 static pinghost_t *ping_receive_ipv6 (pingobj_t *obj, char *buffer,
385 struct icmp6_hdr *icmp_hdr;
392 if (buffer_len < sizeof (struct icmp6_hdr))
395 icmp_hdr = (struct icmp6_hdr *) buffer;
396 buffer += sizeof (struct icmp);
397 buffer_len -= sizeof (struct icmp);
399 if (icmp_hdr->icmp6_type != ICMP6_ECHO_REPLY)
401 dprintf ("Unexpected ICMP type: %02x\n", icmp_hdr->icmp6_type);
405 if (icmp_hdr->icmp6_code != 0)
407 dprintf ("Unexpected ICMP code: %02x\n", icmp_hdr->icmp6_code);
411 ident = ntohs (icmp_hdr->icmp6_id);
412 seq = ntohs (icmp_hdr->icmp6_seq);
414 /* We have to iterate over all hosts, since ICMPv6 packets may
415 * be received on any raw v6 socket. */
416 for (ptr = obj->head; ptr != NULL; ptr = ptr->next)
418 dprintf ("hostname = %s, ident = 0x%04x, seq = %i\n",
419 ptr->hostname, ptr->ident, ((ptr->sequence - 1) & 0xFFFF));
421 if (ptr->addrfamily != AF_INET6)
424 if (!timerisset (ptr->timer))
427 if (ptr->ident != ident)
430 if (((ptr->sequence - 1) & 0xFFFF) != seq)
433 dprintf ("Match found: hostname = %s, ident = 0x%04"PRIx16", "
435 ptr->hostname, ident, seq);
442 dprintf ("No match found for ident = 0x%04"PRIx16", "
450 static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
453 /* Note: 'ph' is not necessarily the host object for which we receive a
454 * reply. The right object will be returned by ping_receive_ipv*(). For
455 * now, we can only rely on ph->fd and ph->addrfamily. */
457 struct timeval diff, pkt_now = *now;
458 pinghost_t *host = NULL;
463 * Set up the receive buffer..
465 struct msghdr msghdr;
466 struct cmsghdr *cmsg;
467 char payload_buffer[4096];
468 ssize_t payload_buffer_len;
469 char control_buffer[4096];
470 struct iovec payload_iovec;
472 memset (&payload_iovec, 0, sizeof (payload_iovec));
473 payload_iovec.iov_base = payload_buffer;
474 payload_iovec.iov_len = sizeof (payload_buffer);
476 memset (&msghdr, 0, sizeof (msghdr));
477 /* unspecified source address */
478 msghdr.msg_name = NULL;
479 msghdr.msg_namelen = 0;
480 /* output buffer vector, see readv(2) */
481 msghdr.msg_iov = &payload_iovec;
482 msghdr.msg_iovlen = 1;
483 /* output buffer for control messages */
484 msghdr.msg_control = control_buffer;
485 msghdr.msg_controllen = sizeof (control_buffer);
486 /* flags; this is an output only field.. */
487 msghdr.msg_flags = 0;
489 msghdr.msg_flags |= MSG_XPG4_2;
492 payload_buffer_len = recvmsg (ph->fd, &msghdr, /* flags = */ 0);
493 if (payload_buffer_len < 0)
496 char errbuf[PING_ERRMSG_LEN];
497 dprintf ("recvfrom: %s\n",
498 sstrerror (errno, errbuf, sizeof (errbuf)));
502 dprintf ("Read %zi bytes from fd = %i\n", payload_buffer_len, ph->fd);
504 /* Iterate over all auxiliary data in msghdr */
507 for (cmsg = CMSG_FIRSTHDR (&msghdr); /* {{{ */
509 cmsg = CMSG_NXTHDR (&msghdr, cmsg))
511 if (cmsg->cmsg_level == SOL_SOCKET)
514 if (cmsg->cmsg_type == SO_TIMESTAMP)
515 memcpy (&pkt_now, CMSG_DATA (cmsg), sizeof (pkt_now));
516 #endif /* SO_TIMESTAMP */
518 else if (ph->addrfamily == AF_INET) /* {{{ */
520 if (cmsg->cmsg_level != IPPROTO_IP)
523 if (cmsg->cmsg_type == IP_TOS)
525 memcpy (&recv_qos, CMSG_DATA (cmsg),
527 dprintf ("TOSv4 = 0x%02"PRIx8";\n", recv_qos);
529 if (cmsg->cmsg_type == IP_TTL)
531 memcpy (&recv_ttl, CMSG_DATA (cmsg),
533 dprintf ("TTLv4 = %i;\n", recv_ttl);
537 dprintf ("Not handling option %i.\n",
541 else if (ph->addrfamily == AF_INET6) /* {{{ */
543 if (cmsg->cmsg_level != IPPROTO_IPV6)
546 if (cmsg->cmsg_type == IPV6_TCLASS)
548 memcpy (&recv_qos, CMSG_DATA (cmsg),
550 dprintf ("TOSv6 = 0x%02"PRIx8";\n", recv_qos);
553 if (cmsg->cmsg_type == IPV6_HOPLIMIT)
555 memcpy (&recv_ttl, CMSG_DATA (cmsg),
557 dprintf ("TTLv6 = %i;\n", recv_ttl);
561 #ifdef IPV6_UNICAST_HOPS
562 if (cmsg->cmsg_type == IPV6_UNICAST_HOPS)
564 memcpy (&recv_ttl, CMSG_DATA (cmsg),
566 dprintf ("TTLv6 = %i;\n", recv_ttl);
570 #ifdef IPV6_MULTICAST_HOPS
571 if (cmsg->cmsg_type == IPV6_MULTICAST_HOPS)
573 memcpy (&recv_ttl, CMSG_DATA (cmsg),
575 dprintf ("TTLv6 = %i;\n", recv_ttl);
580 dprintf ("Not handling option %i.\n",
586 dprintf ("Don't know how to handle "
587 "unknown protocol %i.\n",
590 } /* }}} for (cmsg) */
592 if (ph->addrfamily == AF_INET)
594 host = ping_receive_ipv4 (obj, payload_buffer, payload_buffer_len);
598 else if (ph->addrfamily == AF_INET6)
600 host = ping_receive_ipv6 (obj, payload_buffer, payload_buffer_len);
606 dprintf ("ping_receive_one: Unknown address family %i.\n",
611 dprintf ("rcvd: %12i.%06i\n",
612 (int) pkt_now.tv_sec,
613 (int) pkt_now.tv_usec);
614 dprintf ("sent: %12i.%06i\n",
615 (int) host->timer->tv_sec,
616 (int) host->timer->tv_usec);
618 if (ping_timeval_sub (&pkt_now, host->timer, &diff) < 0)
620 timerclear (host->timer);
624 dprintf ("diff: %12i.%06i\n",
629 host->recv_ttl = recv_ttl;
630 host->recv_qos = recv_qos;
632 host->latency = ((double) diff.tv_usec) / 1000.0;
633 host->latency += ((double) diff.tv_sec) * 1000.0;
635 timerclear (host->timer);
640 /* Blocks until a packet was received from all hosts or the timeout is reached.
641 * When interrupted, (-EINTR) is returned. On error, -1 is returned. On
642 * success, returns zero. */
643 static int ping_receive_all (pingobj_t *obj)
653 struct timeval endtime;
654 struct timeval nowtime;
655 struct timeval timeout;
663 for (ptr = ph; ptr != NULL; ptr = ptr->next)
669 if (gettimeofday (&nowtime, NULL) == -1)
671 ping_set_errno (obj, errno);
676 timeout.tv_sec = (time_t) obj->timeout;
677 timeout.tv_usec = (suseconds_t) (1000000 * (obj->timeout - ((double) timeout.tv_sec)));
679 dprintf ("Set timeout to %i.%06i seconds\n",
680 (int) timeout.tv_sec,
681 (int) timeout.tv_usec);
683 ping_timeval_add (&nowtime, &timeout, &endtime);
692 for (ptr = ph; ptr != NULL; ptr = ptr->next)
694 if (!timerisset (ptr->timer))
697 FD_SET (ptr->fd, &read_fds);
698 FD_SET (ptr->fd, &err_fds);
701 if (max_fd < ptr->fd)
708 if (gettimeofday (&nowtime, NULL) == -1)
710 ping_set_errno (obj, errno);
714 if (ping_timeval_sub (&endtime, &nowtime, &timeout) == -1)
717 dprintf ("Waiting on %i sockets for %i.%06i seconds\n", num_fds,
718 (int) timeout.tv_sec,
719 (int) timeout.tv_usec);
721 status = select (max_fd + 1, &read_fds, NULL, &err_fds, &timeout);
723 if (gettimeofday (&nowtime, NULL) == -1)
725 ping_set_errno (obj, errno);
729 if ((status == -1) && (errno == EINTR))
731 dprintf ("select was interrupted by signal..\n");
732 ping_set_errno (obj, EINTR);
738 char errbuf[PING_ERRMSG_LEN];
739 dprintf ("select: %s\n",
740 sstrerror (errno, errbuf, sizeof (errbuf)));
744 else if (status == 0)
746 dprintf ("select timed out\n");
747 for (ptr = ph; ptr != NULL; ptr = ptr->next)
748 if (ptr->latency < 0.0)
753 for (ptr = ph; ptr != NULL; ptr = ptr->next)
755 if (FD_ISSET (ptr->fd, &read_fds))
757 if (ping_receive_one (obj, ptr, &nowtime) == 0)
760 else if (FD_ISSET (ptr->fd, &err_fds))
762 /* clear the timer in this case so that we
763 * don't run into an endless loop. */
764 /* TODO: Set an error flag in this case. */
765 timerclear (ptr->timer);
771 } /* int ping_receive_all */
773 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
774 * Sending functions: *
777 * +-> ping_send_one_ipv4 *
778 * `-> ping_send_one_ipv6 *
779 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
780 static ssize_t ping_sendto (pingobj_t *obj, pinghost_t *ph,
781 const void *buf, size_t buflen)
785 if (gettimeofday (ph->timer, NULL) == -1)
787 timerclear (ph->timer);
791 ret = sendto (ph->fd, buf, buflen, 0,
792 (struct sockaddr *) ph->addr, ph->addrlen);
796 #if defined(EHOSTUNREACH)
797 if (errno == EHOSTUNREACH)
800 #if defined(ENETUNREACH)
801 if (errno == ENETUNREACH)
804 ping_set_errno (obj, errno);
810 static int ping_send_one_ipv4 (pingobj_t *obj, pinghost_t *ph)
821 dprintf ("ph->hostname = %s\n", ph->hostname);
823 memset (buf, '\0', sizeof (buf));
824 icmp4 = (struct icmp *) buf;
825 data = (char *) (icmp4 + 1);
827 icmp4->icmp_type = ICMP_ECHO;
828 icmp4->icmp_code = 0;
829 icmp4->icmp_cksum = 0;
830 icmp4->icmp_id = htons (ph->ident);
831 icmp4->icmp_seq = htons (ph->sequence);
833 buflen = 4096 - sizeof (struct icmp);
834 strncpy (data, ph->data, buflen);
835 datalen = strlen (data);
837 buflen = datalen + sizeof (struct icmp);
839 icmp4->icmp_cksum = ping_icmp4_checksum (buf, buflen);
841 dprintf ("Sending ICMPv4 package with ID 0x%04x\n", ph->ident);
843 status = ping_sendto (obj, ph, buf, buflen);
846 perror ("ping_sendto");
850 dprintf ("sendto: status = %i\n", status);
855 static int ping_send_one_ipv6 (pingobj_t *obj, pinghost_t *ph)
857 struct icmp6_hdr *icmp6;
866 dprintf ("ph->hostname = %s\n", ph->hostname);
868 memset (buf, '\0', sizeof (buf));
869 icmp6 = (struct icmp6_hdr *) buf;
870 data = (char *) (icmp6 + 1);
872 icmp6->icmp6_type = ICMP6_ECHO_REQUEST;
873 icmp6->icmp6_code = 0;
874 /* The checksum will be calculated by the TCP/IP stack. */
876 icmp6->icmp6_cksum = 0;
877 icmp6->icmp6_id = htons (ph->ident);
878 icmp6->icmp6_seq = htons (ph->sequence);
880 buflen = 4096 - sizeof (struct icmp6_hdr);
881 strncpy (data, ph->data, buflen);
882 datalen = strlen (data);
884 buflen = datalen + sizeof (struct icmp6_hdr);
886 dprintf ("Sending ICMPv6 package with ID 0x%04x\n", ph->ident);
888 status = ping_sendto (obj, ph, buf, buflen);
891 perror ("ping_sendto");
895 dprintf ("sendto: status = %i\n", status);
900 static int ping_send_all (pingobj_t *obj)
910 for (ptr = ph; ptr != NULL; ptr = ptr->next)
912 /* start timer.. The GNU `ping6' starts the timer before
913 * sending the packet, so I will do that too */
914 if (gettimeofday (ptr->timer, NULL) == -1)
917 char errbuf[PING_ERRMSG_LEN];
918 dprintf ("gettimeofday: %s\n",
919 sstrerror (errno, errbuf, sizeof (errbuf)));
921 timerclear (ptr->timer);
927 dprintf ("timer set for hostname = %s\n", ptr->hostname);
930 if (ptr->addrfamily == AF_INET6)
932 dprintf ("Sending ICMPv6 echo request to `%s'\n", ptr->hostname);
933 if (ping_send_one_ipv6 (obj, ptr) != 0)
935 timerclear (ptr->timer);
940 else if (ptr->addrfamily == AF_INET)
942 dprintf ("Sending ICMPv4 echo request to `%s'\n", ptr->hostname);
943 if (ping_send_one_ipv4 (obj, ptr) != 0)
945 timerclear (ptr->timer);
950 else /* this should not happen */
952 dprintf ("Unknown address family: %i\n", ptr->addrfamily);
953 timerclear (ptr->timer);
965 * Set the TTL of a socket protocol independently.
967 static int ping_set_ttl (pinghost_t *ph, int ttl)
971 if (ph->addrfamily == AF_INET)
973 dprintf ("Setting TTLv4 to %i\n", ttl);
974 ret = setsockopt (ph->fd, IPPROTO_IP, IP_TTL,
977 else if (ph->addrfamily == AF_INET6)
979 dprintf ("Setting TTLv6 to %i\n", ttl);
980 ret = setsockopt (ph->fd, IPPROTO_IPV6, IPV6_UNICAST_HOPS,
988 * Set the TOS of a socket protocol independently.
990 * Using SOL_SOCKET / SO_PRIORITY might be a protocol independent way to
991 * set this. See socket(7) for details.
993 static int ping_set_qos (pingobj_t *obj, pinghost_t *ph, uint8_t qos)
996 char errbuf[PING_ERRMSG_LEN];
998 if (ph->addrfamily == AF_INET)
1000 dprintf ("Setting TP_TOS to %#04"PRIx8"\n", qos);
1001 ret = setsockopt (ph->fd, IPPROTO_IP, IP_TOS,
1002 &qos, sizeof (qos));
1006 ping_set_error (obj, "ping_set_qos",
1007 sstrerror (ret, errbuf, sizeof (errbuf)));
1008 dprintf ("Setting TP_TOS failed: %s\n", errbuf);
1011 else if (ph->addrfamily == AF_INET6)
1013 /* IPV6_TCLASS requires an "int". */
1014 int tmp = (int) qos;
1016 dprintf ("Setting IPV6_TCLASS to %#04"PRIx8" (%i)\n", qos, tmp);
1017 ret = setsockopt (ph->fd, IPPROTO_IPV6, IPV6_TCLASS,
1018 &tmp, sizeof (tmp));
1022 ping_set_error (obj, "ping_set_qos",
1023 sstrerror (ret, errbuf, sizeof (errbuf)));
1024 dprintf ("Setting IPV6_TCLASS failed: %s\n", errbuf);
1031 static int ping_get_ident (void)
1034 static int did_seed = 0;
1040 if ((fd = open ("/dev/urandom", O_RDONLY)) != -1)
1044 if (read (fd, &seed, sizeof (seed)) != -1)
1047 dprintf ("Random seed: %#x\n", seed);
1056 char errbuf[PING_ERRMSG_LEN];
1057 dprintf ("open (/dev/urandom): %s\n",
1058 sstrerror (errno, errbuf, sizeof (errbuf)));
1063 retval = (int) random ();
1065 dprintf ("Random number: %#x\n", retval);
1070 static pinghost_t *ping_alloc (void)
1075 ph_size = sizeof (pinghost_t)
1076 + sizeof (struct sockaddr_storage)
1077 + sizeof (struct timeval);
1079 ph = (pinghost_t *) malloc (ph_size);
1083 memset (ph, '\0', ph_size);
1085 ph->timer = (struct timeval *) (ph + 1);
1086 ph->addr = (struct sockaddr_storage *) (ph->timer + 1);
1088 ph->addrlen = sizeof (struct sockaddr_storage);
1092 ph->ident = ping_get_ident () & 0xFFFF;
1097 static void ping_free (pinghost_t *ph)
1102 if (ph->username != NULL)
1103 free (ph->username);
1105 if (ph->hostname != NULL)
1106 free (ph->hostname);
1108 if (ph->data != NULL)
1117 const char *ping_get_error (pingobj_t *obj)
1121 return (obj->errmsg);
1124 pingobj_t *ping_construct (void)
1128 if ((obj = (pingobj_t *) malloc (sizeof (pingobj_t))) == NULL)
1130 memset (obj, 0, sizeof (pingobj_t));
1132 obj->timeout = PING_DEF_TIMEOUT;
1133 obj->ttl = PING_DEF_TTL;
1134 obj->addrfamily = PING_DEF_AF;
1135 obj->data = strdup (PING_DEF_DATA);
1141 void ping_destroy (pingobj_t *obj)
1143 pinghost_t *current;
1149 current = obj->head;
1152 while (current != NULL)
1154 next = current->next;
1155 ping_free (current);
1159 if (obj->data != NULL)
1162 if (obj->srcaddr != NULL)
1163 free (obj->srcaddr);
1165 if (obj->device != NULL)
1173 int ping_setopt (pingobj_t *obj, int option, void *value)
1177 if ((obj == NULL) || (value == NULL))
1186 obj->qos = *((uint8_t *) value);
1187 for (ph = obj->head; ph != NULL; ph = ph->next)
1188 ping_set_qos (obj, ph, obj->qos);
1192 case PING_OPT_TIMEOUT:
1193 obj->timeout = *((double *) value);
1194 if (obj->timeout < 0.0)
1196 obj->timeout = PING_DEF_TIMEOUT;
1202 obj->ttl = *((int *) value);
1203 if ((obj->ttl < 1) || (obj->ttl > 255))
1205 obj->ttl = PING_DEF_TTL;
1212 for (ph = obj->head; ph != NULL; ph = ph->next)
1213 ping_set_ttl (ph, obj->ttl);
1218 obj->addrfamily = *((int *) value);
1219 if ((obj->addrfamily != AF_UNSPEC)
1220 && (obj->addrfamily != AF_INET)
1221 && (obj->addrfamily != AF_INET6))
1223 obj->addrfamily = PING_DEF_AF;
1226 if (obj->srcaddr != NULL)
1228 free (obj->srcaddr);
1229 obj->srcaddr = NULL;
1234 if (obj->data != NULL)
1239 obj->data = strdup ((const char *) value);
1242 case PING_OPT_SOURCE:
1244 char *hostname = (char *) value;
1245 struct addrinfo ai_hints;
1246 struct addrinfo *ai_list;
1249 if (obj->addrfamily != AF_UNSPEC)
1251 dprintf ("Resetting obj->addrfamily to AF_UNSPEC.\n");
1254 memset ((void *) &ai_hints, '\0', sizeof (ai_hints));
1255 ai_hints.ai_family = obj->addrfamily = AF_UNSPEC;
1256 #if defined(AI_ADDRCONFIG)
1257 ai_hints.ai_flags = AI_ADDRCONFIG;
1259 status = getaddrinfo (hostname, NULL, &ai_hints, &ai_list);
1262 #if defined(EAI_SYSTEM)
1263 char errbuf[PING_ERRMSG_LEN];
1265 ping_set_error (obj, "getaddrinfo",
1266 #if defined(EAI_SYSTEM)
1267 (status == EAI_SYSTEM)
1268 ? sstrerror (errno, errbuf, sizeof (errbuf)) :
1270 gai_strerror (status));
1275 if (ai_list->ai_next != NULL)
1277 dprintf ("hostname = `%s' is ambiguous.\n", hostname);
1280 if (obj->srcaddr == NULL)
1282 obj->srcaddrlen = 0;
1283 obj->srcaddr = malloc (sizeof (struct sockaddr_storage));
1284 if (obj->srcaddr == NULL)
1286 ping_set_errno (obj, errno);
1288 freeaddrinfo (ai_list);
1292 memset ((void *) obj->srcaddr, 0, sizeof (struct sockaddr_storage));
1293 assert (ai_list->ai_addrlen <= sizeof (struct sockaddr_storage));
1294 memcpy ((void *) obj->srcaddr, (const void *) ai_list->ai_addr,
1295 ai_list->ai_addrlen);
1296 obj->srcaddrlen = ai_list->ai_addrlen;
1297 obj->addrfamily = ai_list->ai_family;
1299 freeaddrinfo (ai_list);
1300 } /* case PING_OPT_SOURCE */
1303 case PING_OPT_DEVICE:
1305 #ifdef SO_BINDTODEVICE
1306 char *device = strdup ((char *) value);
1310 ping_set_errno (obj, errno);
1315 if (obj->device != NULL)
1317 obj->device = device;
1318 #else /* ! SO_BINDTODEVICE */
1319 ping_set_errno (obj, ENOTSUP);
1321 #endif /* ! SO_BINDTODEVICE */
1322 } /* case PING_OPT_DEVICE */
1327 } /* switch (option) */
1330 } /* int ping_setopt */
1333 int ping_send (pingobj_t *obj)
1338 if (ping_send_all (obj) < 0)
1341 return (ping_receive_all (obj));
1344 static pinghost_t *ping_host_search (pinghost_t *ph, const char *host)
1348 if (strcasecmp (ph->username, host) == 0)
1357 int ping_host_add (pingobj_t *obj, const char *host)
1361 struct addrinfo ai_hints;
1362 struct addrinfo *ai_list, *ai_ptr;
1365 if ((obj == NULL) || (host == NULL))
1368 dprintf ("host = %s\n", host);
1370 if (ping_host_search (obj->head, host) != NULL)
1373 memset (&ai_hints, '\0', sizeof (ai_hints));
1374 ai_hints.ai_flags = 0;
1375 #ifdef AI_ADDRCONFIG
1376 ai_hints.ai_flags |= AI_ADDRCONFIG;
1379 ai_hints.ai_flags |= AI_CANONNAME;
1381 ai_hints.ai_family = obj->addrfamily;
1382 ai_hints.ai_socktype = SOCK_RAW;
1384 if ((ph = ping_alloc ()) == NULL)
1386 dprintf ("Out of memory!\n");
1390 if ((ph->username = strdup (host)) == NULL)
1392 dprintf ("Out of memory!\n");
1393 ping_set_errno (obj, errno);
1398 if ((ph->hostname = strdup (host)) == NULL)
1400 dprintf ("Out of memory!\n");
1401 ping_set_errno (obj, errno);
1406 /* obj->data is not garuanteed to be != NULL */
1407 if ((ph->data = strdup (obj->data == NULL ? PING_DEF_DATA : obj->data)) == NULL)
1409 dprintf ("Out of memory!\n");
1410 ping_set_errno (obj, errno);
1415 if ((ai_return = getaddrinfo (host, NULL, &ai_hints, &ai_list)) != 0)
1417 #if defined(EAI_SYSTEM)
1418 char errbuf[PING_ERRMSG_LEN];
1420 dprintf ("getaddrinfo failed\n");
1421 ping_set_error (obj, "getaddrinfo",
1422 #if defined(EAI_SYSTEM)
1423 (ai_return == EAI_SYSTEM)
1424 ? sstrerror (errno, errbuf, sizeof (errbuf)) :
1426 gai_strerror (ai_return));
1431 if (ai_list == NULL)
1432 ping_set_error (obj, "getaddrinfo", "No hosts returned");
1434 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
1438 if (ai_ptr->ai_family == AF_INET)
1440 ai_ptr->ai_socktype = SOCK_RAW;
1441 ai_ptr->ai_protocol = IPPROTO_ICMP;
1443 else if (ai_ptr->ai_family == AF_INET6)
1445 ai_ptr->ai_socktype = SOCK_RAW;
1446 ai_ptr->ai_protocol = IPPROTO_ICMPV6;
1450 char errmsg[PING_ERRMSG_LEN];
1452 snprintf (errmsg, PING_ERRMSG_LEN, "Unknown `ai_family': %i", ai_ptr->ai_family);
1453 errmsg[PING_ERRMSG_LEN - 1] = '\0';
1455 dprintf ("%s", errmsg);
1456 ping_set_error (obj, "getaddrinfo", errmsg);
1460 /* TODO: Move this to a static function `ping_open_socket' and
1461 * call it whenever the socket dies. */
1462 ph->fd = socket (ai_ptr->ai_family, ai_ptr->ai_socktype, ai_ptr->ai_protocol);
1466 char errbuf[PING_ERRMSG_LEN];
1467 dprintf ("socket: %s\n",
1468 sstrerror (errno, errbuf, sizeof (errbuf)));
1470 ping_set_errno (obj, errno);
1474 if (obj->srcaddr != NULL)
1476 assert (obj->srcaddrlen > 0);
1477 assert (obj->srcaddrlen <= sizeof (struct sockaddr_storage));
1479 if (bind (ph->fd, obj->srcaddr, obj->srcaddrlen) == -1)
1482 char errbuf[PING_ERRMSG_LEN];
1483 dprintf ("bind: %s\n",
1484 sstrerror (errno, errbuf, sizeof (errbuf)));
1486 ping_set_errno (obj, errno);
1493 #ifdef SO_BINDTODEVICE
1494 if (obj->device != NULL)
1496 if (setsockopt (ph->fd, SOL_SOCKET, SO_BINDTODEVICE,
1497 obj->device, strlen (obj->device) + 1) != 0)
1500 char errbuf[PING_ERRMSG_LEN];
1501 dprintf ("setsockopt (SO_BINDTODEVICE): %s\n",
1502 sstrerror (errno, errbuf, sizeof (errbuf)));
1504 ping_set_errno (obj, errno);
1510 #endif /* SO_BINDTODEVICE */
1517 status = setsockopt (ph->fd,
1518 SOL_SOCKET, SO_TIMESTAMP,
1519 &opt, sizeof (opt));
1523 char errbuf[PING_ERRMSG_LEN];
1524 dprintf ("setsockopt (SO_TIMESTAMP): %s\n",
1525 sstrerror (errno, errbuf, sizeof (errbuf)));
1527 ping_set_errno (obj, errno);
1533 #endif /* SO_TIMESTAMP */
1534 assert (sizeof (struct sockaddr_storage) >= ai_ptr->ai_addrlen);
1535 memset (ph->addr, '\0', sizeof (struct sockaddr_storage));
1536 memcpy (ph->addr, ai_ptr->ai_addr, ai_ptr->ai_addrlen);
1537 ph->addrlen = ai_ptr->ai_addrlen;
1538 ph->addrfamily = ai_ptr->ai_family;
1541 if ((ai_ptr->ai_canonname != NULL)
1542 && (strcmp (ph->hostname, ai_ptr->ai_canonname) != 0))
1546 dprintf ("ph->hostname = %s; ai_ptr->ai_canonname = %s;\n",
1547 ph->hostname, ai_ptr->ai_canonname);
1549 old_hostname = ph->hostname;
1550 if ((ph->hostname = strdup (ai_ptr->ai_canonname)) == NULL)
1552 /* strdup failed, falling back to old hostname */
1553 ph->hostname = old_hostname;
1555 else if (old_hostname != NULL)
1557 free (old_hostname);
1560 #endif /* AI_CANONNAME */
1562 if (ph->addrfamily == AF_INET)
1567 /* Enable receiving the TOS field */
1569 setsockopt (ph->fd, IPPROTO_IP, IP_RECVTOS,
1570 &opt, sizeof (opt));
1571 #endif /* IP_RECVTOS */
1573 /* Enable receiving the TTL field */
1575 setsockopt (ph->fd, IPPROTO_IP, IP_RECVTTL,
1576 &opt, sizeof (opt));
1578 #if defined(IPV6_RECVHOPLIMIT) || defined(IPV6_RECVTCLASS)
1579 else if (ph->addrfamily == AF_INET6)
1583 # if defined(IPV6_RECVHOPLIMIT)
1584 /* For details see RFC 3542, section 6.3. */
1586 setsockopt (ph->fd, IPPROTO_IPV6, IPV6_RECVHOPLIMIT,
1587 &opt, sizeof (opt));
1588 # endif /* IPV6_RECVHOPLIMIT */
1590 # if defined(IPV6_RECVTCLASS)
1591 /* For details see RFC 3542, section 6.5. */
1593 setsockopt (ph->fd, IPPROTO_IPV6, IPV6_RECVTCLASS,
1594 &opt, sizeof (opt));
1595 # endif /* IPV6_RECVTCLASS */
1597 #endif /* IPV6_RECVHOPLIMIT || IPV6_RECVTCLASS */
1600 } /* for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next) */
1602 freeaddrinfo (ai_list);
1611 * Adding in the front is much easier, but then the iterator will
1612 * return the host that was added last as first host. That's just not
1615 if (obj->head == NULL)
1624 while (hptr->next != NULL)
1627 assert ((hptr != NULL) && (hptr->next == NULL));
1631 ping_set_ttl (ph, obj->ttl);
1632 ping_set_qos (obj, ph, obj->qos);
1635 } /* int ping_host_add */
1637 int ping_host_remove (pingobj_t *obj, const char *host)
1639 pinghost_t *pre, *cur;
1641 if ((obj == NULL) || (host == NULL))
1649 if (strcasecmp (host, cur->username) == 0)
1658 ping_set_error (obj, "ping_host_remove", "Host not found");
1663 obj->head = cur->next;
1665 pre->next = cur->next;
1672 pingobj_iter_t *ping_iterator_get (pingobj_t *obj)
1676 return ((pingobj_iter_t *) obj->head);
1679 pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter)
1683 return ((pingobj_iter_t *) iter->next);
1686 int ping_iterator_get_info (pingobj_iter_t *iter, int info,
1687 void *buffer, size_t *buffer_len)
1691 size_t orig_buffer_len = *buffer_len;
1693 if ((iter == NULL) || (buffer_len == NULL))
1696 if ((buffer == NULL) && (*buffer_len != 0 ))
1701 case PING_INFO_USERNAME:
1703 *buffer_len = strlen (iter->username) + 1;
1704 if (orig_buffer_len <= *buffer_len)
1706 /* Since (orig_buffer_len > *buffer_len) `strncpy'
1707 * will copy `*buffer_len' and pad the rest of
1708 * `buffer' with null-bytes */
1709 strncpy (buffer, iter->username, orig_buffer_len);
1713 case PING_INFO_HOSTNAME:
1715 *buffer_len = strlen (iter->hostname) + 1;
1716 if (orig_buffer_len < *buffer_len)
1718 /* Since (orig_buffer_len > *buffer_len) `strncpy'
1719 * will copy `*buffer_len' and pad the rest of
1720 * `buffer' with null-bytes */
1721 strncpy (buffer, iter->hostname, orig_buffer_len);
1725 case PING_INFO_ADDRESS:
1726 ret = getnameinfo ((struct sockaddr *) iter->addr,
1734 if ((ret == EAI_MEMORY)
1736 || (ret == EAI_OVERFLOW)
1740 #if defined(EAI_SYSTEM)
1741 else if (ret == EAI_SYSTEM)
1749 case PING_INFO_FAMILY:
1751 *buffer_len = sizeof (int);
1752 if (orig_buffer_len < sizeof (int))
1754 *((int *) buffer) = iter->addrfamily;
1758 case PING_INFO_LATENCY:
1760 *buffer_len = sizeof (double);
1761 if (orig_buffer_len < sizeof (double))
1763 *((double *) buffer) = iter->latency;
1767 case PING_INFO_DROPPED:
1769 *buffer_len = sizeof (uint32_t);
1770 if (orig_buffer_len < sizeof (uint32_t))
1772 *((uint32_t *) buffer) = iter->dropped;
1776 case PING_INFO_SEQUENCE:
1778 *buffer_len = sizeof (unsigned int);
1779 if (orig_buffer_len < sizeof (unsigned int))
1781 *((unsigned int *) buffer) = (unsigned int) iter->sequence;
1785 case PING_INFO_IDENT:
1787 *buffer_len = sizeof (uint16_t);
1788 if (orig_buffer_len < sizeof (uint16_t))
1790 *((uint16_t *) buffer) = (uint16_t) iter->ident;
1794 case PING_INFO_DATA:
1796 *buffer_len = strlen (iter->data);
1797 if (orig_buffer_len < *buffer_len)
1799 strncpy ((char *) buffer, iter->data, orig_buffer_len);
1803 case PING_INFO_RECV_TTL:
1805 *buffer_len = sizeof (int);
1806 if (orig_buffer_len < sizeof (int))
1808 *((int *) buffer) = iter->recv_ttl;
1812 case PING_INFO_RECV_QOS:
1814 if (*buffer_len>sizeof(unsigned)) *buffer_len=sizeof(unsigned);
1815 if (!*buffer_len) *buffer_len=1;
1816 if (orig_buffer_len < *buffer_len)
1818 memcpy(buffer,&iter->recv_qos,*buffer_len);
1824 } /* ping_iterator_get_info */
1826 void *ping_iterator_get_context (pingobj_iter_t *iter)
1830 return (iter->context);
1833 void ping_iterator_set_context (pingobj_iter_t *iter, void *context)
1837 iter->context = context;