TCPSPRAY(1)							   User's Manual						       TCPSPRAY(1)

NAME

       tcpspray - TCP/IP bandwidth measurement tool (Discard and Echo client)

SYNOPSIS

       tcpspray [-46ev] [-b block_size] [-d wait_us] [ -f filename] [-n count] <hostname> [port]

DESCRIPTON

       tcpspray  uses  the Discard resp. Echo protocol (RFC 863 resp. RFC 862) to perform bandwidth measurements of TCP sessions between the local
       system, and a Discard resp. Echo server.

       Unix-based hosts can provide a Discard and/or Echo servers with the Internet super-server inetd. On Windows NT, the simple  network  proto-
       cols optional component will do the same.

       The  name  or  address  of  the server node must be specified. tcpspray will automatically try to use IPv6 when available. If not, or if it
       fails, it will fallback to IPv4. However, tcpspray4 resp. tcpspray6 only try to use IPv4 resp. IPv6.

OPTIONS

       -4 or --ipv4
	      Force usage of TCP over IPv4.

       -6 or --ipv6
	      Force usage of TCP over IPv6.

       -b block_size or --bsize block_size
	      Send block of the specified byte size (default: 1024).

       -d wait_us or --delay wait_us
	      Waits for the given amount of microseconds after any given was sent before attempting to send the next one. There  is  no  delay	by
	      default.

       -e or --echo
	      Use  the Echo protocol instead of Discard. tcpspray will measure the time required to send data and receive it back, instead of sim-
	      ply sending it.

       -f filename or --fill filename
	      Read data from the specified file to fill sent blocks with. If the file is smaller than the size of blocks, or if no file were spec-
	      ified, the remaining trailing bytes are all set to zero.

       -h or --help
	      Display some help and exit.

       -n block_count or --count block_count
	      Send the specified amount of data blocks for the measurements (default: 100).

       -V or --version
	      Display program version and license and exit.

       -v or --verbose
	      Display  more verbose informations. In particular, tcpspray will print a dot each time a block is sent. If the Echo protocol is used
	      (option -e), dots will be erased as data is received back.

DIAGNOSTICS

       If you get no response while you know the remote host is up, it is most likely that it has no Discard/Echo service running, or  that  these
       services  are  blocked  by  a firewall. Running tcptraceroute6(8) resp.	tcptraceroute(8) toward the IPv6 resp. IPv4 remote host might help
       detecting such a situation.

SECURITY

       tcpspray does not require any privilege to run.

SEE ALSO

       tcp(7), inetd(8), tcptraceroute6(8), tcptraceroute(8)

AUTHOR

       Remi Denis-Courmont <remi at remlab dot net>

       $Id: tcpspray.1 658 2010-10-31 20:56:30Z remi $

       http://www.remlab.net/ndisc6/

tcpspray				      $Date: 2010-10-31 22:56:30 +0200 (dim. 31 oct. 2010) $				       TCPSPRAY(1)