Seth Woolley's Man Viewer

bing(8) - bing - compute point to point throughput using two sizes of ICMP ECHO_REQUEST packets to pairs of remote hosts - man 8 bing

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

BING(8)                  UNIX System Manager's Manual                  BING(8)



NAME
       bing  -  compute  point  to  point  throughput  using two sizes of ICMP
       ECHO_REQUEST packets to pairs of remote hosts.

SYNOPSIS
       bing [dDnrRPvVwz] [-c count] [-e samples] [-f samplefile] [-i wait] [-p
       pattern] [-s small packetsize] [-S big packetsize] host1 host2 [...]

DESCRIPTION
       Bing  determines  bandwidth  on  a  point-to-point link(1,2) by sending ICMP
       ECHO_REQUEST packets and measuring their roundtrip times for  different
       packet sizes on each end of the link.


       host1 is supposed to be the nearest end of the link(1,2), while host2 is the
       other end.

       The options are as follows:

       -c count
            Stop after count resets of the stats. Useful only  in(1,8)  conjunction
            with the -e option. Defaults to 1.

       -d   Set the SO_DEBUG option on the socket(2,7,n) being used.

       -D   Display  the  measured  throughput  at  every  received packet. By
            default, it is displayed only when  the  computed  value  changes,
            which  itself changes only when the minimum roundtrip time(1,2,n) for one
            of the packet sizes changes.

       -e samples
            Reset stats after sending samples ECHO_REQUEST packets.

       -f samplefile
            Saves the bandwidth measurements to the file(1,n) samplefile.

       -i wait
            Wait wait seconds for each ECHO_REPLY packet. The  default  is  to
            wait for four seconds.

       -n   Numeric  output  only.  No attempt will be made to lookup symbolic
            names for host(1,5) addresses.

       -P   Be pedantic regarding round-trip times.

            Normally, bing assumes that the roundtrip time(1,2,n) for a small  packet
            should  always be smaller than the roundtrip time(1,2,n) for a big packet
            to the same host(1,5), that for a given size  the  roundtrip  time(1,2,n)  for
            host1  should always be smaller than the roundtrip time(1,2,n) for host2,
            and that the increase in(1,8) the  roundtrip  time(1,2,n)  between  host1  and
            host2 should always be bigger for big packets than for small pack-
            ets.

            Bing takes advantage of  this  to  better  determine  the  minimum
            roundtrip times.

            Option  -P disables this behaviour, in(1,8) the unlikely event it could
            be of any use someday. Even IP/X25 links are not weird  enough  to
            require this, though.

       -p pattern
            You  may specify up to 16 ``pad'' bytes to fill out the packet you
            send.  This is useful for diagnosing data-dependent problems in(1,8)  a
            network.   For example, ``-p ff'' will cause the sent packet to be
            filled with all ones.

       -R   Record route. Includes the RECORD_ROUTE option in(1,8) the ECHO_REQUEST
            packet  and  displays  the  route buffer on returned packets. Note
            that the IP header is only large enough for nine such routes. Many
            hosts ignore or discard this option.

       -r   Bypass the normal routing tables and send(2,n) directly to a host(1,5) on an
            attached network. If the host(1,5) is not on a  directly-attached  net-
            work,  an  error(8,n)  is  returned.  This option can be used to ping a
            local host(1,5) through an interface  that  has  no  route  through  it
            (e.g., after the interface was dropped by routed(8)).

       -s small packetsize
            Specifies  the  number of data bytes to be sent in(1,8) the small pack-
            ets. The default and minimum value is 44.

       -S big packetsize
            Specifies the number of data bytes to be sent in(1,8) the big  packets.
            The  default  is 108. The size should be chosen so that big packet
            roundtrip times are long enough to be accurately measured (depend-
            ing on clock(3,n) resolution and number of hops).

       -u size increment
            Specifies  that  bing  should start sending packets of the size of
            small packetsize and then increase  the  size  by  size  increment
            until it reaches big packetsize.

       -v   Verbose  output.  ICMP  packets  other than ECHO_RESPONSE that are
            received are listed.

       -V   Very verbose output. The roundtrip time(1,2,n) of each received  echo(1,3x,1 builtins)  is
            displayed.

       -w   Display  possible warnings about roundtrip times all the time.  By
            default, warnings are printed only at the end.

       -z   Fill packets with uncompressible (pseudo-random) data.

       Round-trip times and packet loss statistics are computed. If  duplicate
       packets are received, they are not included in(1,8) the packet loss calcula-
       tion, although the round trip time(1,2,n) of these packets is used  in(1,8)  calcu-
       lating  the  minimum/average/maximum  round-trip time(1,2,n) numbers. When the
       specified number of loops have been made or if(3,n) the  program  is  termi-
       nated with a SIGINT, a brief summary is displayed.

       This  program  is  intended for use in(1,8) network testing, measurement and
       management. Because of the load(7,n) it can impose on  the  network,  it  is
       unwise  to use bing during normal operations or from automated scripts.

BUGS
       Many Hosts and Gateways ignore the RECORD_ROUTE option.

       The maximum IP header length is too small for options like RECORD_ROUTE
       to  be  completely useful. There's not much that that can be done about
       this, however.

       Some of the final stats (average throughputs) almost never give a  even
       marginally correct result.

SEE ALSO
       netstat(1), ifconfig(8), ping(8), routed(8), traceroute(8)

AUTHOR
       Pierre Beyssac <pb@fasterix.freenix.fr>

       Port to Windows: Francois Gouget <fgouget@mygale.org>



                                 April 3, 1995                         BING(8)

References for this manual (incoming links)