2 * Object oriented C module to send ICMP and ICMPv6 `echo's.
3 * Copyright (C) 2006-2010 Florian octo Forster <octo at verplant.org>
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
28 # include <inttypes.h>
32 # error "You don't have the standard C99 header files installed"
33 #endif /* STDC_HEADERS */
47 # include <sys/types.h>
50 # include <sys/stat.h>
53 #if TIME_WITH_SYS_TIME
54 # include <sys/time.h>
58 # include <sys/time.h>
65 # include <sys/socket.h>
72 #if HAVE_NETINET_IN_SYSTM_H
73 # include <netinet/in_systm.h>
76 # include <netinet/in.h>
79 # include <netinet/ip.h>
81 #if HAVE_NETINET_IP_ICMP_H
82 # include <netinet/ip_icmp.h>
84 #ifdef HAVE_NETINET_IP_VAR_H
85 # include <netinet/ip_var.h>
87 #if HAVE_NETINET_IP6_H
88 # include <netinet/ip6.h>
90 #if HAVE_NETINET_ICMP6_H
91 # include <netinet/icmp6.h>
97 # define dprintf(...) printf ("%s[%4i]: %-20s: ", __FILE__, __LINE__, __FUNCTION__); printf (__VA_ARGS__)
99 # define dprintf(...) /**/
102 #define PING_ERRMSG_LEN 256
106 /* username: name passed in by the user */
108 /* hostname: name returned by the reverse lookup */
110 struct sockaddr_storage *addr;
116 struct timeval *timer;
125 struct pinghost *next;
136 struct sockaddr *srcaddr;
137 socklen_t srcaddrlen;
141 char errmsg[PING_ERRMSG_LEN];
147 * private (static) functions
149 /* Even though Posix requires "strerror_r" to return an "int",
150 * some systems (e.g. the GNU libc) return a "char *" _and_
151 * ignore the second argument ... -tokkee */
152 static char *sstrerror (int errnum, char *buf, size_t buflen)
158 snprintf (buf, buflen, "Error %i (%#x)", errnum, errnum);
160 /* #endif !HAVE_STRERROR_R */
162 #elif STRERROR_R_CHAR_P
165 temp = strerror_r (errnum, buf, buflen);
168 if ((temp != NULL) && (temp != buf) && (temp[0] != 0))
169 strncpy (buf, temp, buflen);
171 strncpy (buf, "strerror_r did not return "
172 "an error message", buflen);
175 /* #endif STRERROR_R_CHAR_P */
178 if (strerror_r (errnum, buf, buflen) != 0)
180 snprintf (buf, buflen, "Error %i (%#x); "
181 "Additionally, strerror_r failed.",
184 #endif /* STRERROR_R_CHAR_P */
189 } /* char *sstrerror */
191 static void ping_set_error (pingobj_t *obj, const char *function,
194 snprintf (obj->errmsg, sizeof (obj->errmsg),
195 "%s: %s", function, message);
196 obj->errmsg[sizeof (obj->errmsg) - 1] = 0;
199 static void ping_set_errno (pingobj_t *obj, int error_number)
201 sstrerror (error_number, obj->errmsg, sizeof (obj->errmsg));
204 static int ping_timeval_add (struct timeval *tv1, struct timeval *tv2,
207 res->tv_sec = tv1->tv_sec + tv2->tv_sec;
208 res->tv_usec = tv1->tv_usec + tv2->tv_usec;
210 while (res->tv_usec > 1000000)
212 res->tv_usec -= 1000000;
219 static int ping_timeval_sub (struct timeval *tv1, struct timeval *tv2,
222 if ((tv1->tv_sec < tv2->tv_sec)
223 || ((tv1->tv_sec == tv2->tv_sec)
224 && (tv1->tv_usec < tv2->tv_usec)))
227 res->tv_sec = tv1->tv_sec - tv2->tv_sec;
228 res->tv_usec = tv1->tv_usec - tv2->tv_usec;
230 assert ((res->tv_sec > 0) || ((res->tv_sec == 0) && (res->tv_usec >= 0)));
232 while (res->tv_usec < 0)
234 res->tv_usec += 1000000;
241 static uint16_t ping_icmp4_checksum (char *buf, size_t len)
248 for (ptr = (uint16_t *) buf; len > 1; ptr++, len -= 2)
253 *(char *) &ret = *(char *) ptr;
257 /* Do this twice to get all possible carries.. */
258 sum = (sum >> 16) + (sum & 0xFFFF);
259 sum = (sum >> 16) + (sum & 0xFFFF);
266 static pinghost_t *ping_receive_ipv4 (pingobj_t *obj, char *buffer,
270 struct icmp *icmp_hdr;
274 uint16_t recv_checksum;
275 uint16_t calc_checksum;
282 if (buffer_len < sizeof (struct ip))
285 ip_hdr = (struct ip *) buffer;
286 ip_hdr_len = ip_hdr->ip_hl << 2;
288 if (buffer_len < ip_hdr_len)
291 buffer += ip_hdr_len;
292 buffer_len -= ip_hdr_len;
294 if (buffer_len < sizeof (struct icmp))
297 icmp_hdr = (struct icmp *) buffer;
298 buffer += sizeof (struct icmp);
299 buffer_len -= sizeof (struct icmp);
301 if (icmp_hdr->icmp_type != ICMP_ECHOREPLY)
303 dprintf ("Unexpected ICMP type: %i\n", icmp_hdr->icmp_type);
307 recv_checksum = icmp_hdr->icmp_cksum;
308 icmp_hdr->icmp_cksum = 0;
309 calc_checksum = ping_icmp4_checksum ((char *) icmp_hdr,
310 sizeof (struct icmp) + buffer_len);
312 if (recv_checksum != calc_checksum)
314 dprintf ("Checksum missmatch: Got 0x%04"PRIx16", "
315 "calculated 0x%04"PRIx16"\n",
316 recv_checksum, calc_checksum);
320 ident = ntohs (icmp_hdr->icmp_id);
321 seq = ntohs (icmp_hdr->icmp_seq);
323 /* We have to iterate over all hosts, since ICMPv4 packets may
324 * be received on any raw v4 socket. */
325 for (ptr = obj->head; ptr != NULL; ptr = ptr->next)
327 dprintf ("hostname = %s, ident = 0x%04x, seq = %i\n",
328 ptr->hostname, ptr->ident, ((ptr->sequence - 1) & 0xFFFF));
330 if (ptr->addrfamily != AF_INET)
333 if (!timerisset (ptr->timer))
336 if (ptr->ident != ident)
339 if (((ptr->sequence - 1) & 0xFFFF) != seq)
342 dprintf ("Match found: hostname = %s, ident = 0x%04"PRIx16", "
344 ptr->hostname, ident, seq);
351 dprintf ("No match found for ident = 0x%04"PRIx16", seq = %"PRIu16"\n",
356 ptr->recv_ttl = (int) ip_hdr->ip_ttl;
357 ptr->recv_qos = (uint8_t) ip_hdr->ip_tos;
362 #ifndef ICMP6_ECHO_REQUEST
363 # ifdef ICMP6_ECHO /* AIX netinet/ip6_icmp.h */
364 # define ICMP6_ECHO_REQUEST ICMP6_ECHO
366 # define ICMP6_ECHO_REQUEST 128
370 #ifndef ICMP6_ECHO_REPLY
371 # ifdef ICMP6_ECHOREPLY /* AIX netinet/ip6_icmp.h */
372 # define ICMP6_ECHO_REPLY ICMP6_ECHOREPLY
374 # define ICMP6_ECHO_REPLY 129
378 static pinghost_t *ping_receive_ipv6 (pingobj_t *obj, char *buffer,
381 struct icmp6_hdr *icmp_hdr;
388 if (buffer_len < sizeof (struct icmp6_hdr))
391 icmp_hdr = (struct icmp6_hdr *) buffer;
392 buffer += sizeof (struct icmp);
393 buffer_len -= sizeof (struct icmp);
395 if (icmp_hdr->icmp6_type != ICMP6_ECHO_REPLY)
397 dprintf ("Unexpected ICMP type: %02x\n", icmp_hdr->icmp6_type);
401 if (icmp_hdr->icmp6_code != 0)
403 dprintf ("Unexpected ICMP code: %02x\n", icmp_hdr->icmp6_code);
407 ident = ntohs (icmp_hdr->icmp6_id);
408 seq = ntohs (icmp_hdr->icmp6_seq);
410 /* We have to iterate over all hosts, since ICMPv6 packets may
411 * be received on any raw v6 socket. */
412 for (ptr = obj->head; ptr != NULL; ptr = ptr->next)
414 dprintf ("hostname = %s, ident = 0x%04x, seq = %i\n",
415 ptr->hostname, ptr->ident, ((ptr->sequence - 1) & 0xFFFF));
417 if (ptr->addrfamily != AF_INET6)
420 if (!timerisset (ptr->timer))
423 if (ptr->ident != ident)
426 if (((ptr->sequence - 1) & 0xFFFF) != seq)
429 dprintf ("Match found: hostname = %s, ident = 0x%04"PRIx16", "
431 ptr->hostname, ident, seq);
438 dprintf ("No match found for ident = 0x%04"PRIx16", "
446 static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
449 /* Note: 'ph' is not necessarily the host object for which we receive a
450 * reply. The right object will be returned by ping_receive_ipv*(). For
451 * now, we can only rely on ph->fd and ph->addrfamily. */
454 pinghost_t *host = NULL;
459 * Set up the receive buffer..
461 struct msghdr msghdr;
462 struct cmsghdr *cmsg;
463 char payload_buffer[4096];
464 ssize_t payload_buffer_len;
465 char control_buffer[4096];
466 struct iovec payload_iovec;
468 memset (&payload_iovec, 0, sizeof (payload_iovec));
469 payload_iovec.iov_base = payload_buffer;
470 payload_iovec.iov_len = sizeof (payload_buffer);
472 memset (&msghdr, 0, sizeof (msghdr));
473 /* unspecified source address */
474 msghdr.msg_name = NULL;
475 msghdr.msg_namelen = 0;
476 /* output buffer vector, see readv(2) */
477 msghdr.msg_iov = &payload_iovec;
478 msghdr.msg_iovlen = 1;
479 /* output buffer for control messages */
480 msghdr.msg_control = control_buffer;
481 msghdr.msg_controllen = sizeof (control_buffer);
482 /* flags; this is an output only field.. */
483 msghdr.msg_flags = 0;
485 msghdr.msg_flags |= MSG_XPG4_2;
488 payload_buffer_len = recvmsg (ph->fd, &msghdr, /* flags = */ 0);
489 if (payload_buffer_len < 0)
492 char errbuf[PING_ERRMSG_LEN];
493 dprintf ("recvfrom: %s\n",
494 sstrerror (errno, errbuf, sizeof (errbuf)));
498 dprintf ("Read %zi bytes from fd = %i\n", payload_buffer_len, ph->fd);
500 /* Iterate over all auxiliary data in msghdr */
503 for (cmsg = CMSG_FIRSTHDR (&msghdr); /* {{{ */
505 cmsg = CMSG_NXTHDR (&msghdr, cmsg))
507 if (ph->addrfamily == AF_INET) /* {{{ */
509 if (cmsg->cmsg_level != IPPROTO_IP)
512 if (cmsg->cmsg_type == IP_TOS)
514 memcpy (&recv_qos, CMSG_DATA (cmsg),
516 dprintf ("TOSv4 = 0x%02"PRIx8";\n", recv_qos);
518 if (cmsg->cmsg_type == IP_TTL)
520 memcpy (&recv_ttl, CMSG_DATA (cmsg),
522 dprintf ("TTLv4 = %i;\n", recv_ttl);
526 dprintf ("Not handling option %i.\n",
530 else if (ph->addrfamily == AF_INET6) /* {{{ */
532 if (cmsg->cmsg_level != IPPROTO_IPV6)
535 if (cmsg->cmsg_type == IPV6_TCLASS)
537 memcpy (&recv_qos, CMSG_DATA (cmsg),
539 dprintf ("TOSv6 = 0x%02"PRIx8";\n", recv_qos);
541 if (cmsg->cmsg_type == IPV6_HOPLIMIT)
543 memcpy (&recv_ttl, CMSG_DATA (cmsg),
545 dprintf ("TTLv6 = %i;\n", recv_ttl);
549 dprintf ("Not handling option %i.\n",
555 dprintf ("Don't know how to handle "
556 "unknown protocol %i.\n",
559 } /* }}} for (cmsg) */
561 if (ph->addrfamily == AF_INET)
563 host = ping_receive_ipv4 (obj, payload_buffer, payload_buffer_len);
567 else if (ph->addrfamily == AF_INET6)
569 host = ping_receive_ipv6 (obj, payload_buffer, payload_buffer_len);
575 dprintf ("ping_receive_one: Unknown address family %i.\n",
580 dprintf ("rcvd: %12i.%06i\n",
583 dprintf ("sent: %12i.%06i\n",
584 (int) host->timer->tv_sec,
585 (int) host->timer->tv_usec);
587 if (ping_timeval_sub (now, host->timer, &diff) < 0)
589 timerclear (host->timer);
593 dprintf ("diff: %12i.%06i\n",
598 host->recv_ttl = recv_ttl;
599 if (recv_qos != 0xffff)
600 host->recv_qos = recv_qos;
602 host->latency = ((double) diff.tv_usec) / 1000.0;
603 host->latency += ((double) diff.tv_sec) * 1000.0;
605 timerclear (host->timer);
610 static int ping_receive_all (pingobj_t *obj)
620 struct timeval endtime;
621 struct timeval nowtime;
622 struct timeval timeout;
630 for (ptr = ph; ptr != NULL; ptr = ptr->next)
636 if (gettimeofday (&nowtime, NULL) == -1)
638 ping_set_errno (obj, errno);
643 timeout.tv_sec = (time_t) obj->timeout;
644 timeout.tv_usec = (suseconds_t) (1000000 * (obj->timeout - ((double) timeout.tv_sec)));
646 dprintf ("Set timeout to %i.%06i seconds\n",
647 (int) timeout.tv_sec,
648 (int) timeout.tv_usec);
650 ping_timeval_add (&nowtime, &timeout, &endtime);
659 for (ptr = ph; ptr != NULL; ptr = ptr->next)
661 if (!timerisset (ptr->timer))
664 FD_SET (ptr->fd, &read_fds);
665 FD_SET (ptr->fd, &err_fds);
668 if (max_fd < ptr->fd)
675 if (gettimeofday (&nowtime, NULL) == -1)
677 ping_set_errno (obj, errno);
681 if (ping_timeval_sub (&endtime, &nowtime, &timeout) == -1)
684 dprintf ("Waiting on %i sockets for %i.%06i seconds\n", num_fds,
685 (int) timeout.tv_sec,
686 (int) timeout.tv_usec);
688 status = select (max_fd + 1, &read_fds, NULL, &err_fds, &timeout);
690 if (gettimeofday (&nowtime, NULL) == -1)
692 ping_set_errno (obj, errno);
696 if ((status == -1) && (errno == EINTR))
698 dprintf ("select was interrupted by signal..\n");
704 char errbuf[PING_ERRMSG_LEN];
705 dprintf ("select: %s\n",
706 sstrerror (errno, errbuf, sizeof (errbuf)));
710 else if (status == 0)
712 dprintf ("select timed out\n");
713 for (ptr = ph; ptr != NULL; ptr = ptr->next)
714 if (ptr->latency < 0.0)
719 for (ptr = ph; ptr != NULL; ptr = ptr->next)
721 if (FD_ISSET (ptr->fd, &read_fds))
723 if (ping_receive_one (obj, ptr, &nowtime) == 0)
726 else if (FD_ISSET (ptr->fd, &err_fds))
728 /* clear the timer in this case so that we
729 * don't run into an endless loop. */
730 /* TODO: Set an error flag in this case. */
731 timerclear (ptr->timer);
739 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
740 * Sending functions: *
743 * +-> ping_send_one_ipv4 *
744 * `-> ping_send_one_ipv6 *
745 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
746 static ssize_t ping_sendto (pingobj_t *obj, pinghost_t *ph,
747 const void *buf, size_t buflen)
751 if (gettimeofday (ph->timer, NULL) == -1)
753 timerclear (ph->timer);
757 ret = sendto (ph->fd, buf, buflen, 0,
758 (struct sockaddr *) ph->addr, ph->addrlen);
762 #if defined(EHOSTUNREACH)
763 if (errno == EHOSTUNREACH)
766 #if defined(ENETUNREACH)
767 if (errno == ENETUNREACH)
770 ping_set_errno (obj, errno);
776 static int ping_send_one_ipv4 (pingobj_t *obj, pinghost_t *ph)
787 dprintf ("ph->hostname = %s\n", ph->hostname);
789 memset (buf, '\0', sizeof (buf));
790 icmp4 = (struct icmp *) buf;
791 data = (char *) (icmp4 + 1);
793 icmp4->icmp_type = ICMP_ECHO;
794 icmp4->icmp_code = 0;
795 icmp4->icmp_cksum = 0;
796 icmp4->icmp_id = htons (ph->ident);
797 icmp4->icmp_seq = htons (ph->sequence);
799 buflen = 4096 - sizeof (struct icmp);
800 strncpy (data, ph->data, buflen);
801 datalen = strlen (data);
803 buflen = datalen + sizeof (struct icmp);
805 icmp4->icmp_cksum = ping_icmp4_checksum (buf, buflen);
807 dprintf ("Sending ICMPv4 package with ID 0x%04x\n", ph->ident);
809 status = ping_sendto (obj, ph, buf, buflen);
812 perror ("ping_sendto");
816 dprintf ("sendto: status = %i\n", status);
821 static int ping_send_one_ipv6 (pingobj_t *obj, pinghost_t *ph)
823 struct icmp6_hdr *icmp6;
832 dprintf ("ph->hostname = %s\n", ph->hostname);
834 memset (buf, '\0', sizeof (buf));
835 icmp6 = (struct icmp6_hdr *) buf;
836 data = (char *) (icmp6 + 1);
838 icmp6->icmp6_type = ICMP6_ECHO_REQUEST;
839 icmp6->icmp6_code = 0;
840 /* The checksum will be calculated by the TCP/IP stack. */
842 icmp6->icmp6_cksum = 0;
843 icmp6->icmp6_id = htons (ph->ident);
844 icmp6->icmp6_seq = htons (ph->sequence);
846 buflen = 4096 - sizeof (struct icmp6_hdr);
847 strncpy (data, ph->data, buflen);
848 datalen = strlen (data);
850 buflen = datalen + sizeof (struct icmp6_hdr);
852 dprintf ("Sending ICMPv6 package with ID 0x%04x\n", ph->ident);
854 status = ping_sendto (obj, ph, buf, buflen);
857 perror ("ping_sendto");
861 dprintf ("sendto: status = %i\n", status);
866 static int ping_send_all (pingobj_t *obj)
876 for (ptr = ph; ptr != NULL; ptr = ptr->next)
878 /* start timer.. The GNU `ping6' starts the timer before
879 * sending the packet, so I will do that too */
880 if (gettimeofday (ptr->timer, NULL) == -1)
883 char errbuf[PING_ERRMSG_LEN];
884 dprintf ("gettimeofday: %s\n",
885 sstrerror (errno, errbuf, sizeof (errbuf)));
887 timerclear (ptr->timer);
893 dprintf ("timer set for hostname = %s\n", ptr->hostname);
896 if (ptr->addrfamily == AF_INET6)
898 dprintf ("Sending ICMPv6 echo request to `%s'\n", ptr->hostname);
899 if (ping_send_one_ipv6 (obj, ptr) != 0)
901 timerclear (ptr->timer);
906 else if (ptr->addrfamily == AF_INET)
908 dprintf ("Sending ICMPv4 echo request to `%s'\n", ptr->hostname);
909 if (ping_send_one_ipv4 (obj, ptr) != 0)
911 timerclear (ptr->timer);
916 else /* this should not happen */
918 dprintf ("Unknown address family: %i\n", ptr->addrfamily);
919 timerclear (ptr->timer);
931 * Set the TTL of a socket protocol independently.
933 static int ping_set_ttl (pinghost_t *ph, int ttl)
937 if (ph->addrfamily == AF_INET)
939 dprintf ("Setting TTLv4 to %i\n", ttl);
940 ret = setsockopt (ph->fd, IPPROTO_IP, IP_TTL,
943 else if (ph->addrfamily == AF_INET6)
945 dprintf ("Setting TTLv6 to %i\n", ttl);
946 ret = setsockopt (ph->fd, IPPROTO_IPV6, IPV6_UNICAST_HOPS,
954 * Set the TOS of a socket protocol independently.
956 * Using SOL_SOCKET / SO_PRIORITY might be a protocol independent way to
957 * set this. See socket(7) for details.
959 static int ping_set_qos (pingobj_t *obj, pinghost_t *ph, uint8_t qos)
962 char errbuf[PING_ERRMSG_LEN];
964 if (ph->addrfamily == AF_INET)
966 dprintf ("Setting TP_TOS to %#04"PRIx8"\n", qos);
967 ret = setsockopt (ph->fd, IPPROTO_IP, IP_TOS,
972 ping_set_error (obj, "ping_set_qos",
973 sstrerror (ret, errbuf, sizeof (errbuf)));
974 dprintf ("Setting TP_TOS failed: %s\n", errbuf);
977 else if (ph->addrfamily == AF_INET6)
979 /* IPV6_TCLASS requires an "int". */
982 dprintf ("Setting IPV6_TCLASS to %#04"PRIx8" (%i)\n", qos, tmp);
983 ret = setsockopt (ph->fd, IPPROTO_IPV6, IPV6_TCLASS,
988 ping_set_error (obj, "ping_set_qos",
989 sstrerror (ret, errbuf, sizeof (errbuf)));
990 dprintf ("Setting IPV6_TCLASS failed: %s\n", errbuf);
997 static int ping_get_ident (void)
1000 static int did_seed = 0;
1006 if ((fd = open ("/dev/urandom", O_RDONLY)) != -1)
1010 if (read (fd, &seed, sizeof (seed)) != -1)
1013 dprintf ("Random seed: %#x\n", seed);
1022 char errbuf[PING_ERRMSG_LEN];
1023 dprintf ("open (/dev/urandom): %s\n",
1024 sstrerror (errno, errbuf, sizeof (errbuf)));
1029 retval = (int) random ();
1031 dprintf ("Random number: %#x\n", retval);
1036 static pinghost_t *ping_alloc (void)
1041 ph_size = sizeof (pinghost_t)
1042 + sizeof (struct sockaddr_storage)
1043 + sizeof (struct timeval);
1045 ph = (pinghost_t *) malloc (ph_size);
1049 memset (ph, '\0', ph_size);
1051 ph->timer = (struct timeval *) (ph + 1);
1052 ph->addr = (struct sockaddr_storage *) (ph->timer + 1);
1054 ph->addrlen = sizeof (struct sockaddr_storage);
1058 ph->ident = ping_get_ident () & 0xFFFF;
1063 static void ping_free (pinghost_t *ph)
1068 if (ph->username != NULL)
1069 free (ph->username);
1071 if (ph->hostname != NULL)
1072 free (ph->hostname);
1074 if (ph->data != NULL)
1083 const char *ping_get_error (pingobj_t *obj)
1087 return (obj->errmsg);
1090 pingobj_t *ping_construct (void)
1094 if ((obj = (pingobj_t *) malloc (sizeof (pingobj_t))) == NULL)
1096 memset (obj, 0, sizeof (pingobj_t));
1098 obj->timeout = PING_DEF_TIMEOUT;
1099 obj->ttl = PING_DEF_TTL;
1100 obj->addrfamily = PING_DEF_AF;
1101 obj->data = strdup (PING_DEF_DATA);
1107 void ping_destroy (pingobj_t *obj)
1109 pinghost_t *current;
1115 current = obj->head;
1118 while (current != NULL)
1120 next = current->next;
1121 ping_free (current);
1125 if (obj->data != NULL)
1128 if (obj->srcaddr != NULL)
1129 free (obj->srcaddr);
1131 if (obj->device != NULL)
1139 int ping_setopt (pingobj_t *obj, int option, void *value)
1143 if ((obj == NULL) || (value == NULL))
1152 obj->qos = *((uint8_t *) value);
1153 for (ph = obj->head; ph != NULL; ph = ph->next)
1154 ping_set_qos (obj, ph, obj->qos);
1158 case PING_OPT_TIMEOUT:
1159 obj->timeout = *((double *) value);
1160 if (obj->timeout < 0.0)
1162 obj->timeout = PING_DEF_TIMEOUT;
1168 obj->ttl = *((int *) value);
1169 if ((obj->ttl < 1) || (obj->ttl > 255))
1171 obj->ttl = PING_DEF_TTL;
1178 for (ph = obj->head; ph != NULL; ph = ph->next)
1179 ping_set_ttl (ph, obj->ttl);
1184 obj->addrfamily = *((int *) value);
1185 if ((obj->addrfamily != AF_UNSPEC)
1186 && (obj->addrfamily != AF_INET)
1187 && (obj->addrfamily != AF_INET6))
1189 obj->addrfamily = PING_DEF_AF;
1192 if (obj->srcaddr != NULL)
1194 free (obj->srcaddr);
1195 obj->srcaddr = NULL;
1200 if (obj->data != NULL)
1205 obj->data = strdup ((const char *) value);
1208 case PING_OPT_SOURCE:
1210 char *hostname = (char *) value;
1211 struct addrinfo ai_hints;
1212 struct addrinfo *ai_list;
1215 if (obj->addrfamily != AF_UNSPEC)
1217 dprintf ("Resetting obj->addrfamily to AF_UNSPEC.\n");
1220 memset ((void *) &ai_hints, '\0', sizeof (ai_hints));
1221 ai_hints.ai_family = obj->addrfamily = AF_UNSPEC;
1222 #if defined(AI_ADDRCONFIG)
1223 ai_hints.ai_flags = AI_ADDRCONFIG;
1225 status = getaddrinfo (hostname, NULL, &ai_hints, &ai_list);
1228 #if defined(EAI_SYSTEM)
1229 char errbuf[PING_ERRMSG_LEN];
1231 ping_set_error (obj, "getaddrinfo",
1232 #if defined(EAI_SYSTEM)
1233 (status == EAI_SYSTEM)
1234 ? sstrerror (errno, errbuf, sizeof (errbuf)) :
1236 gai_strerror (status));
1241 if (ai_list->ai_next != NULL)
1243 dprintf ("hostname = `%s' is ambiguous.\n", hostname);
1246 if (obj->srcaddr == NULL)
1248 obj->srcaddrlen = 0;
1249 obj->srcaddr = malloc (sizeof (struct sockaddr_storage));
1250 if (obj->srcaddr == NULL)
1252 ping_set_errno (obj, errno);
1254 freeaddrinfo (ai_list);
1258 memset ((void *) obj->srcaddr, 0, sizeof (struct sockaddr_storage));
1259 assert (ai_list->ai_addrlen <= sizeof (struct sockaddr_storage));
1260 memcpy ((void *) obj->srcaddr, (const void *) ai_list->ai_addr,
1261 ai_list->ai_addrlen);
1262 obj->srcaddrlen = ai_list->ai_addrlen;
1263 obj->addrfamily = ai_list->ai_family;
1265 freeaddrinfo (ai_list);
1266 } /* case PING_OPT_SOURCE */
1269 case PING_OPT_DEVICE:
1271 #ifdef SO_BINDTODEVICE
1272 char *device = strdup ((char *) value);
1276 ping_set_errno (obj, errno);
1281 if (obj->device != NULL)
1283 obj->device = device;
1284 #else /* ! SO_BINDTODEVICE */
1285 ping_set_errno (obj, ENOTSUP);
1287 #endif /* ! SO_BINDTODEVICE */
1288 } /* case PING_OPT_DEVICE */
1293 } /* switch (option) */
1296 } /* int ping_setopt */
1299 int ping_send (pingobj_t *obj)
1306 if (ping_send_all (obj) < 0)
1309 if ((ret = ping_receive_all (obj)) < 0)
1315 static pinghost_t *ping_host_search (pinghost_t *ph, const char *host)
1319 if (strcasecmp (ph->username, host) == 0)
1328 int ping_host_add (pingobj_t *obj, const char *host)
1332 struct addrinfo ai_hints;
1333 struct addrinfo *ai_list, *ai_ptr;
1336 if ((obj == NULL) || (host == NULL))
1339 dprintf ("host = %s\n", host);
1341 if (ping_host_search (obj->head, host) != NULL)
1344 memset (&ai_hints, '\0', sizeof (ai_hints));
1345 ai_hints.ai_flags = 0;
1346 #ifdef AI_ADDRCONFIG
1347 ai_hints.ai_flags |= AI_ADDRCONFIG;
1350 ai_hints.ai_flags |= AI_CANONNAME;
1352 ai_hints.ai_family = obj->addrfamily;
1353 ai_hints.ai_socktype = SOCK_RAW;
1355 if ((ph = ping_alloc ()) == NULL)
1357 dprintf ("Out of memory!\n");
1361 if ((ph->username = strdup (host)) == NULL)
1363 dprintf ("Out of memory!\n");
1364 ping_set_errno (obj, errno);
1369 if ((ph->hostname = strdup (host)) == NULL)
1371 dprintf ("Out of memory!\n");
1372 ping_set_errno (obj, errno);
1377 /* obj->data is not garuanteed to be != NULL */
1378 if ((ph->data = strdup (obj->data == NULL ? PING_DEF_DATA : obj->data)) == NULL)
1380 dprintf ("Out of memory!\n");
1381 ping_set_errno (obj, errno);
1386 if ((ai_return = getaddrinfo (host, NULL, &ai_hints, &ai_list)) != 0)
1388 #if defined(EAI_SYSTEM)
1389 char errbuf[PING_ERRMSG_LEN];
1391 dprintf ("getaddrinfo failed\n");
1392 ping_set_error (obj, "getaddrinfo",
1393 #if defined(EAI_SYSTEM)
1394 (ai_return == EAI_SYSTEM)
1395 ? sstrerror (errno, errbuf, sizeof (errbuf)) :
1397 gai_strerror (ai_return));
1402 if (ai_list == NULL)
1403 ping_set_error (obj, "getaddrinfo", "No hosts returned");
1405 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
1409 if (ai_ptr->ai_family == AF_INET)
1411 ai_ptr->ai_socktype = SOCK_RAW;
1412 ai_ptr->ai_protocol = IPPROTO_ICMP;
1414 else if (ai_ptr->ai_family == AF_INET6)
1416 ai_ptr->ai_socktype = SOCK_RAW;
1417 ai_ptr->ai_protocol = IPPROTO_ICMPV6;
1421 char errmsg[PING_ERRMSG_LEN];
1423 snprintf (errmsg, PING_ERRMSG_LEN, "Unknown `ai_family': %i", ai_ptr->ai_family);
1424 errmsg[PING_ERRMSG_LEN - 1] = '\0';
1427 ping_set_error (obj, "getaddrinfo", errmsg);
1431 /* TODO: Move this to a static function `ping_open_socket' and
1432 * call it whenever the socket dies. */
1433 ph->fd = socket (ai_ptr->ai_family, ai_ptr->ai_socktype, ai_ptr->ai_protocol);
1437 char errbuf[PING_ERRMSG_LEN];
1438 dprintf ("socket: %s\n",
1439 sstrerror (errno, errbuf, sizeof (errbuf)));
1441 ping_set_errno (obj, errno);
1445 if (obj->srcaddr != NULL)
1447 assert (obj->srcaddrlen > 0);
1448 assert (obj->srcaddrlen <= sizeof (struct sockaddr_storage));
1450 if (bind (ph->fd, obj->srcaddr, obj->srcaddrlen) == -1)
1453 char errbuf[PING_ERRMSG_LEN];
1454 dprintf ("bind: %s\n",
1455 sstrerror (errno, errbuf, sizeof (errbuf)));
1457 ping_set_errno (obj, errno);
1464 #ifdef SO_BINDTODEVICE
1465 if (obj->device != NULL)
1467 if (setsockopt (ph->fd, SOL_SOCKET, SO_BINDTODEVICE,
1468 obj->device, strlen (obj->device) + 1) != 0)
1471 char errbuf[PING_ERRMSG_LEN];
1472 dprintf ("setsockopt: %s\n",
1473 sstrerror (errno, errbuf, sizeof (errbuf)));
1475 ping_set_errno (obj, errno);
1481 #endif /* SO_BINDTODEVICE */
1483 assert (sizeof (struct sockaddr_storage) >= ai_ptr->ai_addrlen);
1484 memset (ph->addr, '\0', sizeof (struct sockaddr_storage));
1485 memcpy (ph->addr, ai_ptr->ai_addr, ai_ptr->ai_addrlen);
1486 ph->addrlen = ai_ptr->ai_addrlen;
1487 ph->addrfamily = ai_ptr->ai_family;
1490 if ((ai_ptr->ai_canonname != NULL)
1491 && (strcmp (ph->hostname, ai_ptr->ai_canonname) != 0))
1495 dprintf ("ph->hostname = %s; ai_ptr->ai_canonname = %s;\n",
1496 ph->hostname, ai_ptr->ai_canonname);
1498 old_hostname = ph->hostname;
1499 if ((ph->hostname = strdup (ai_ptr->ai_canonname)) == NULL)
1501 /* strdup failed, falling back to old hostname */
1502 ph->hostname = old_hostname;
1504 else if (old_hostname != NULL)
1506 free (old_hostname);
1509 #endif /* AI_CANONNAME */
1511 if (ph->addrfamily == AF_INET)
1515 /* Enable receiving the TOS field */
1517 setsockopt (ph->fd, IPPROTO_IP, IP_RECVTOS,
1518 &opt, sizeof (opt));
1520 /* Enable receiving the TTL field */
1522 setsockopt (ph->fd, IPPROTO_IP, IP_RECVTTL,
1523 &opt, sizeof (opt));
1525 #if defined(IPV6_RECVHOPLIMIT) || defined(IPV6_RECVTCLASS)
1526 else if (ph->addrfamily == AF_INET6)
1530 # if defined(IPV6_RECVHOPLIMIT)
1531 /* For details see RFC 3542, section 6.3. */
1533 setsockopt (ph->fd, IPPROTO_IPV6, IPV6_RECVHOPLIMIT,
1534 &opt, sizeof (opt));
1535 # endif /* IPV6_RECVHOPLIMIT */
1537 # if defined(IPV6_RECVTCLASS)
1538 /* For details see RFC 3542, section 6.5. */
1540 setsockopt (ph->fd, IPPROTO_IPV6, IPV6_RECVTCLASS,
1541 &opt, sizeof (opt));
1542 # endif /* IPV6_RECVTCLASS */
1544 #endif /* IPV6_RECVHOPLIMIT || IPV6_RECVTCLASS */
1547 } /* for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next) */
1549 freeaddrinfo (ai_list);
1558 * Adding in the front is much easier, but then the iterator will
1559 * return the host that was added last as first host. That's just not
1562 if (obj->head == NULL)
1571 while (hptr->next != NULL)
1574 assert ((hptr != NULL) && (hptr->next == NULL));
1578 ping_set_ttl (ph, obj->ttl);
1579 ping_set_qos (obj, ph, obj->qos);
1582 } /* int ping_host_add */
1584 int ping_host_remove (pingobj_t *obj, const char *host)
1586 pinghost_t *pre, *cur;
1588 if ((obj == NULL) || (host == NULL))
1596 if (strcasecmp (host, cur->username) == 0)
1605 ping_set_error (obj, "ping_host_remove", "Host not found");
1610 obj->head = cur->next;
1612 pre->next = cur->next;
1619 pingobj_iter_t *ping_iterator_get (pingobj_t *obj)
1623 return ((pingobj_iter_t *) obj->head);
1626 pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter)
1630 return ((pingobj_iter_t *) iter->next);
1633 int ping_iterator_get_info (pingobj_iter_t *iter, int info,
1634 void *buffer, size_t *buffer_len)
1638 size_t orig_buffer_len = *buffer_len;
1640 if ((iter == NULL) || (buffer_len == NULL))
1643 if ((buffer == NULL) && (*buffer_len != 0 ))
1648 case PING_INFO_USERNAME:
1650 *buffer_len = strlen (iter->username) + 1;
1651 if (orig_buffer_len <= *buffer_len)
1653 /* Since (orig_buffer_len > *buffer_len) `strncpy'
1654 * will copy `*buffer_len' and pad the rest of
1655 * `buffer' with null-bytes */
1656 strncpy (buffer, iter->username, orig_buffer_len);
1660 case PING_INFO_HOSTNAME:
1662 *buffer_len = strlen (iter->hostname) + 1;
1663 if (orig_buffer_len < *buffer_len)
1665 /* Since (orig_buffer_len > *buffer_len) `strncpy'
1666 * will copy `*buffer_len' and pad the rest of
1667 * `buffer' with null-bytes */
1668 strncpy (buffer, iter->hostname, orig_buffer_len);
1672 case PING_INFO_ADDRESS:
1673 ret = getnameinfo ((struct sockaddr *) iter->addr,
1681 if ((ret == EAI_MEMORY)
1683 || (ret == EAI_OVERFLOW)
1687 #if defined(EAI_SYSTEM)
1688 else if (ret == EAI_SYSTEM)
1696 case PING_INFO_FAMILY:
1698 *buffer_len = sizeof (int);
1699 if (orig_buffer_len < sizeof (int))
1701 *((int *) buffer) = iter->addrfamily;
1705 case PING_INFO_LATENCY:
1707 *buffer_len = sizeof (double);
1708 if (orig_buffer_len < sizeof (double))
1710 *((double *) buffer) = iter->latency;
1714 case PING_INFO_DROPPED:
1716 *buffer_len = sizeof (uint32_t);
1717 if (orig_buffer_len < sizeof (uint32_t))
1719 *((uint32_t *) buffer) = iter->dropped;
1723 case PING_INFO_SEQUENCE:
1725 *buffer_len = sizeof (unsigned int);
1726 if (orig_buffer_len < sizeof (unsigned int))
1728 *((unsigned int *) buffer) = (unsigned int) iter->sequence;
1732 case PING_INFO_IDENT:
1734 *buffer_len = sizeof (uint16_t);
1735 if (orig_buffer_len < sizeof (uint16_t))
1737 *((uint16_t *) buffer) = (uint16_t) iter->ident;
1741 case PING_INFO_DATA:
1743 *buffer_len = strlen (iter->data);
1744 if (orig_buffer_len < *buffer_len)
1746 strncpy ((char *) buffer, iter->data, orig_buffer_len);
1750 case PING_INFO_RECV_TTL:
1752 *buffer_len = sizeof (int);
1753 if (orig_buffer_len < sizeof (int))
1755 *((int *) buffer) = iter->recv_ttl;
1759 case PING_INFO_RECV_QOS:
1761 if (*buffer_len>sizeof(unsigned)) *buffer_len=sizeof(unsigned);
1762 if (!*buffer_len) *buffer_len=1;
1763 if (orig_buffer_len < *buffer_len)
1765 memcpy(buffer,&iter->recv_qos,*buffer_len);
1771 } /* ping_iterator_get_info */
1773 void *ping_iterator_get_context (pingobj_iter_t *iter)
1777 return (iter->context);
1780 void ping_iterator_set_context (pingobj_iter_t *iter, void *context)
1784 iter->context = context;