tcpspray(1)

1TCPSPRAY(1)                      User's Manual                     TCPSPRAY(1)
2
3
4

NAME

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

SYNOPSIS

9       tcpspray [-46ev] [-b block_size] [-d wait_µs] [ -f filename] [-n count]
10       <hostname> [port]
11
12

DESCRIPTON

14       tcpspray uses the Discard resp. Echo protocol (RFC 863  resp.  RFC 862)
15       to  perform  bandwidth  measurements  of TCP sessions between the local
16       system, and a Discard resp. Echo server.
17
18       Unix-based hosts can provide a Discard and/or  Echo  servers  with  the
19       Internet  super-server  inetd. On Windows NT, the simple network proto‐
20       cols optional component will do the same.
21
22       The name or address of the server node must be specified. tcpspray will
23       automatically  try  to use IPv6 when available. If not, or if it fails,
24       it will fallback to IPv4. However, tcpspray4 resp. tcpspray6  only  try
25       to use IPv4 resp. IPv6.
26
27

OPTIONS

29       -4 or --ipv4
30              Force usage of TCP over IPv4.
31
32
33       -6 or --ipv6
34              Force usage of TCP over IPv6.
35
36
37       -b block_size or --bsize block_size
38              Send block of the specified byte size (default: 1024).
39
40
41       -d wait_µs or --delay wait_µs
42              Waits  for  the given amount of microseconds after any given was
43              sent before attempting to send the next one. There is  no  delay
44              by default.
45
46
47       -e or --echo
48              Use  the Echo protocol instead of Discard. tcpspray will measure
49              the time required to send data and receive it back,  instead  of
50              simply sending it.
51
52
53       -f filename or --fill filename
54              Read  data  from the specified file to fill sent blocks with. If
55              the file is smaller than the size of blocks, or if no file  were
56              specified, the remaining trailing bytes are all set to zero.
57
58
59       -h or --help
60              Display some help and exit.
61
62
63       -n block_count or --count block_count
64              Send  the  specified  amount of data blocks for the measurements
65              (default: 100).
66
67
68       -V or --version
69              Display program version and license and exit.
70
71
72       -v or --verbose
73              Display more verbose informations. In particular, tcpspray  will
74              print  a  dot each time a block is sent. If the Echo protocol is
75              used (option -e), dots will be erased as data is received back.
76
77

DIAGNOSTICS

79       If you get no response while you know the remote host is up, it is most
80       likely  that it has no Discard/Echo service running, or that these ser‐
81       vices are blocked by a firewall. Running tcptraceroute6(8) resp.   tcp‐
82       traceroute(8) toward the IPv6 resp. IPv4 remote host might help detect‐
83       ing such a situation.
84
85

SECURITY

87       tcpspray does not require any privilege to run.
88
89

AUTHOR

95       Rémi Denis-Courmont <remi at remlab dot net>
96
97       http://www.remlab.net/ndisc6/
98
99
100
101tcpspray                            $Date$                         TCPSPRAY(1)