NAME

       speedometer - measure and display the rate of data across a network connection

SYNOPSIS

          speedometer [options] tap [[-c] tap] ...

DESCRIPTION

       Monitor network traffic or speed/progress of a file transfer. At least one tap option (-f,
       -rx, -tx) must be entered. Option -c starts a new column, otherwise taps are piled
       vertically.

       Note: before you use the program, satrt generating traffic by transferring files in/out
       e.g. with scp(1) in the network you're measuring.

OPTIONS

       -b  Use old blocky display instead of smoothed display even when UTF-8 encoding is
           detected.

       -f filename [size]
           Display download speed with progress bar. This option must be used if directly
           following another file tap without an expected size specified.

       -i interval
           Interval in seconds. Examples: 5 or 0.25". Default is 1.

       -p  Use plain-text display (one tap only).

       -rx iface
           Display bytes received on network interface.

       -tx iface
           Display bytes transmitted on network interface.

       -z  Report zero size on files that don't exist instead of waiting for them to be created

       EXAMPLES

       How long it will take for my 38MB transfer to finish?

           speedometer favorite_episode.rm $(( 38 * 1024 * 1024 ))

       How quickly is another transfer going?

           speedometer dl/big.avi

       How fast is this LAN?

           host-a$ cat /dev/zero | nc -l -p 12345
           host-b$ nc host-a 12345 > /dev/null
           host-b$ speedometer -rx eth0

       How fast is the upstream on this ADSL line?

           speedometer -tx ppp0

       How fast can I write data to my filesystem? (with at least 1GB free)

           dd bs=1000000 count=1000 if=/dev/zero of=bigfile &
           speedometer bigfile

ENVIRONMENT

       None.

FILES

       None.

SEE ALSO

       htop(1) iotop(1) scp(1) top(1) vmstat(1)

AUTHORS

       Program was written by Ian Ward <ian.ward@excess.org>

       This manual page was written by Jari Aalto <jari.aalto@cante.net>.  Released under license
       GNU GPL version 2 or (at your option) any later version. For more information about
       license, visit <http://www.gnu.org/copyleft/gpl.html>.