Rename "ToS" to "QoS" everywhere, to account for DSCP being used in IPv6 …
authorFlorian Forster <octo@verplant.org>
Wed, 27 Oct 2010 07:59:09 +0000 (09:59 +0200)
committerFlorian Forster <octo@verplant.org>
Wed, 27 Oct 2010 08:04:54 +0000 (10:04 +0200)
… and recommended for IPv4.

src/liboping.c
src/mans/ping_setopt.pod
src/oping.c
src/oping.h

index 6e8d755..a272e2c 100644 (file)
@@ -117,7 +117,7 @@ struct pinghost
        double                   latency;
        uint32_t                 dropped;
        int                      recv_ttl;
-       uint8_t                  recv_tos;
+       uint8_t                  recv_qos;
        char                    *data;
 
        void                    *context;
@@ -130,7 +130,7 @@ struct pingobj
        double                   timeout;
        int                      ttl;
        int                      addrfamily;
-       uint8_t                  tos;
+       uint8_t                  qos;
        char                    *data;
 
        struct sockaddr         *srcaddr;
@@ -354,7 +354,7 @@ static pinghost_t *ping_receive_ipv4 (pingobj_t *obj, char *buffer,
 
        if (ptr != NULL){
                ptr->recv_ttl = (int)     ip_hdr->ip_ttl;
-               ptr->recv_tos = (uint8_t) ip_hdr->ip_tos;
+               ptr->recv_qos = (uint8_t) ip_hdr->ip_tos;
        }
        return (ptr);
 }
@@ -453,7 +453,7 @@ static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
        struct timeval diff;
        pinghost_t *host = NULL;
        int recv_ttl;
-       uint8_t recv_tos;
+       uint8_t recv_qos;
        
        /*
         * Set up the receive buffer..
@@ -499,7 +499,7 @@ static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
 
        /* Iterate over all auxiliary data in msghdr */
        recv_ttl = -1;
-       recv_tos = 0xff;
+       recv_qos = 0xff;
        for (cmsg = CMSG_FIRSTHDR (&msghdr); /* {{{ */
                        cmsg != NULL;
                        cmsg = CMSG_NXTHDR (&msghdr, cmsg))
@@ -511,9 +511,9 @@ static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
 
                        if (cmsg->cmsg_type == IP_TOS)
                        {
-                               memcpy (&recv_tos, CMSG_DATA (cmsg),
-                                               sizeof (recv_tos));
-                               dprintf ("TOSv4 = 0x%02"PRIx8";\n", recv_tos);
+                               memcpy (&recv_qos, CMSG_DATA (cmsg),
+                                               sizeof (recv_qos));
+                               dprintf ("TOSv4 = 0x%02"PRIx8";\n", recv_qos);
                        } else
                        if (cmsg->cmsg_type == IP_TTL)
                        {
@@ -534,9 +534,9 @@ static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
 
                        if (cmsg->cmsg_type == IPV6_TCLASS)
                        {
-                               memcpy (&recv_tos, CMSG_DATA (cmsg),
-                                               sizeof (recv_tos));
-                               dprintf ("TOSv6 = 0x%02"PRIx8";\n", recv_tos);
+                               memcpy (&recv_qos, CMSG_DATA (cmsg),
+                                               sizeof (recv_qos));
+                               dprintf ("TOSv6 = 0x%02"PRIx8";\n", recv_qos);
                        } else
                        if (cmsg->cmsg_type == IPV6_HOPLIMIT)
                        {
@@ -596,8 +596,8 @@ static int ping_receive_one (pingobj_t *obj, const pinghost_t *ph,
 
        if (recv_ttl >= 0)
                host->recv_ttl = recv_ttl;
-       if (recv_tos != 0xffff)
-               host->recv_tos = recv_tos;
+       if (recv_qos != 0xffff)
+               host->recv_qos = recv_qos;
 
        host->latency  = ((double) diff.tv_usec) / 1000.0;
        host->latency += ((double) diff.tv_sec)  * 1000.0;
@@ -956,20 +956,20 @@ static int ping_set_ttl (pinghost_t *ph, int ttl)
  * Using SOL_SOCKET / SO_PRIORITY might be a protocol independent way to
  * set this. See socket(7) for details.
  */
-static int ping_set_tos (pingobj_t *obj, pinghost_t *ph, uint8_t tos)
+static int ping_set_qos (pingobj_t *obj, pinghost_t *ph, uint8_t qos)
 {
        int ret = EINVAL;
        char errbuf[PING_ERRMSG_LEN];
 
        if (ph->addrfamily == AF_INET)
        {
-               dprintf ("Setting TP_TOS to %#04"PRIx8"\n", tos);
+               dprintf ("Setting TP_TOS to %#04"PRIx8"\n", qos);
                ret = setsockopt (ph->fd, IPPROTO_IP, IP_TOS,
-                               &tos, sizeof (tos));
+                               &qos, sizeof (qos));
                if (ret != 0)
                {
                        ret = errno;
-                       ping_set_error (obj, "ping_set_tos",
+                       ping_set_error (obj, "ping_set_qos",
                                        sstrerror (ret, errbuf, sizeof (errbuf)));
                        dprintf ("Setting TP_TOS failed: %s\n", errbuf);
                }
@@ -977,15 +977,15 @@ static int ping_set_tos (pingobj_t *obj, pinghost_t *ph, uint8_t tos)
        else if (ph->addrfamily == AF_INET6)
        {
                /* IPV6_TCLASS requires an "int". */
-               int tmp = (int) tos;
+               int tmp = (int) qos;
 
-               dprintf ("Setting IPV6_TCLASS to %#04"PRIx8" (%i)\n", tos, tmp);
+               dprintf ("Setting IPV6_TCLASS to %#04"PRIx8" (%i)\n", qos, tmp);
                ret = setsockopt (ph->fd, IPPROTO_IPV6, IPV6_TCLASS,
                                &tmp, sizeof (tmp));
                if (ret != 0)
                {
                        ret = errno;
-                       ping_set_error (obj, "ping_set_tos",
+                       ping_set_error (obj, "ping_set_qos",
                                        sstrerror (ret, errbuf, sizeof (errbuf)));
                        dprintf ("Setting IPV6_TCLASS failed: %s\n", errbuf);
                }
@@ -1099,7 +1099,7 @@ pingobj_t *ping_construct (void)
        obj->ttl        = PING_DEF_TTL;
        obj->addrfamily = PING_DEF_AF;
        obj->data       = strdup (PING_DEF_DATA);
-       obj->tos        = 0;
+       obj->qos        = 0;
 
        return (obj);
 }
@@ -1145,13 +1145,13 @@ int ping_setopt (pingobj_t *obj, int option, void *value)
 
        switch (option)
        {
-               case PING_OPT_TOS:
+               case PING_OPT_QOS:
                {
                        pinghost_t *ph;
 
-                       obj->tos = *((uint8_t *) value);
+                       obj->qos = *((uint8_t *) value);
                        for (ph = obj->head; ph != NULL; ph = ph->next)
-                               ping_set_tos (obj, ph, obj->tos);
+                               ping_set_qos (obj, ph, obj->qos);
                        break;
                }
 
@@ -1576,7 +1576,7 @@ int ping_host_add (pingobj_t *obj, const char *host)
        }
 
        ping_set_ttl (ph, obj->ttl);
-       ping_set_tos (obj, ph, obj->tos);
+       ping_set_qos (obj, ph, obj->qos);
 
        return (0);
 } /* int ping_host_add */
@@ -1756,13 +1756,13 @@ int ping_iterator_get_info (pingobj_iter_t *iter, int info,
                        ret = 0;
                        break;
 
-               case PING_INFO_RECV_TOS:
+               case PING_INFO_RECV_QOS:
                        ret = ENOMEM;
                        if (*buffer_len>sizeof(unsigned)) *buffer_len=sizeof(unsigned);
                        if (!*buffer_len) *buffer_len=1;
                        if (orig_buffer_len < *buffer_len)
                                break;
-                       memcpy(buffer,&iter->recv_tos,*buffer_len);
+                       memcpy(buffer,&iter->recv_qos,*buffer_len);
                        ret = 0;
                        break;
        }
index 70be1b6..582b355 100644 (file)
@@ -66,14 +66,14 @@ char-pointer to a null-terminated string specifying an interface name
 operating systems. In that case, B<ping_setopt> sets the error to
 C<operation not supported>.
 
-=item B<PING_OPT_TOS>
+=item B<PING_OPT_QOS>
 
-Sets the I<Type of Service> flags that should be used when crafting ICMP and
+Sets the I<Quality of Service> flags that should be used when crafting ICMP and
 ICMPv6 packets. The memory pointed to by I<val> is interpreted as a C<uint8_t>.
 The byte is passed to L<setsockopt(2)> without modification, using the
 C<IP_TOS> (IPv4) or C<IPV6_TCLASS> (IPv6) option. It is the caller's
-responsibility to chose a valid bit combination. For details, read L<ip(7)> and
-L<ipv6(7)>.
+responsibility to chose a valid bit combination. For details, read the L<ip(7)>
+and L<ipv6(7)> manual pages, as well as I<RFCE<nbsp>2474>.
 
 =back
 
@@ -95,4 +95,4 @@ L<liboping(3)>
 liboping is written by Florian octo Forster E<lt>octo at verplant.orgE<gt>.
 Its homepage can be found at L<http://verplant.org/liboping/>.
 
-(c) 2005-2009 by Florian octo Forster.
+(c) 2005-2010 by Florian octo Forster.
index 5c1d8a1..240e7e7 100644 (file)
@@ -786,7 +786,7 @@ static void update_host_hook (pingobj_iter_t *iter, /* {{{ */
 
        recv_tos = 0;
        buffer_len = sizeof (recv_tos);
-       ping_iterator_get_info (iter, PING_INFO_RECV_TOS,
+       ping_iterator_get_info (iter, PING_INFO_RECV_QOS,
                        &recv_tos, &buffer_len);
 
        data_len = 0;
@@ -986,7 +986,7 @@ int main (int argc, char **argv) /* {{{ */
                                opt_send_ttl, ping_get_error (ping));
        }
 
-       if (ping_setopt (ping, PING_OPT_TOS, &opt_send_qos) != 0)
+       if (ping_setopt (ping, PING_OPT_QOS, &opt_send_qos) != 0)
        {
                fprintf (stderr, "Setting TOS to %i failed: %s\n",
                                opt_send_qos, ping_get_error (ping));
index 1ce94aa..1935436 100644 (file)
@@ -52,7 +52,7 @@ typedef struct pingobj pingobj_t;
 #define PING_OPT_DATA    0x08
 #define PING_OPT_SOURCE  0x10
 #define PING_OPT_DEVICE  0x20
-#define PING_OPT_TOS     0x40
+#define PING_OPT_QOS     0x40
 
 #define PING_DEF_TIMEOUT 1.0
 #define PING_DEF_TTL     255
@@ -85,7 +85,7 @@ pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter);
 #define PING_INFO_USERNAME  8
 #define PING_INFO_DROPPED   9
 #define PING_INFO_RECV_TTL 10
-#define PING_INFO_RECV_TOS 11
+#define PING_INFO_RECV_QOS 11
 int ping_iterator_get_info (pingobj_iter_t *iter, int info,
                void *buffer, size_t *buffer_len);