NAME

       tcpspray - print average throughput for a tcp connection

SYNOPSIS

       tcpspray [ -v ] [ -e ] [ -h ] [ -b blksize ] [ -n nblks ]
            [ -f filename ] hostname

DESCRIPTION

       tcpspray  sends  data  to  either  the  discard  or echo TCP service on the specified host and prints the
       average throughput.

OPTIONS

       -v             Prints a dot for each block sent. Will also print a backspace for each block  received  in
                      echo mode.  Note: the I/O required for this option will affect the throughput rates.

       -e             Use  the  TCP echo service instead of discard (the default) and print throughput rates for
                      both transmission and reception.

       -h             Print a usage description.

       -b blksize     Sets the size of a block (the internal buffer) in bytes.  Defaults to 1024.

       -n nblks       Sets the number of blocks to transfer.  Defaults to 100.

       -f filename    Copy the contents of the specified file into the internal buffer  (sized  by  -b  option).
                      The  buffer  is  zeroed by default.  If the file is larger than the buffer, only the first
                      blksize bytes will be used.  If the file is smaller than the buffer, the  remaining  bytes
                      are zeroed.

                      This  option  is  useful  in  determining  the  relationship  of  the  data transferred to
                      throughput.  E.g., if data compression is used on any of the intermediate links comprising
                      the TCP connection, preloading the buffer with a text file will produce greater throughput
                      than with a file that has already been compressed.

       -d delay       Sets the time in microseconds  to  wait  between  successive  buffer  transmissions.   The
                      default is no delay.

SEE ALSO

       ping(8), spray(8)

AUTHOR

       Greg Christy (gmc@quotron.com)

                                                 23 October 1991                                     TCPSPRAY(1)