TCPBENCH(1) OpenBSD Reference Manual TCPBENCH(1)NAME
tcpbench - TCP benchmarking and measurement tool
SYNOPSIS
tcpbench -l
tcpbench [-v] [-B buf] [-k kvars] [-n connections] [-p port] [-r rate]
[-S space] [-V rtable] hostname
tcpbench -s [-v] [-B buf] [-k kvars] [-p port] [-r rate] [-S space]
[-V rtable]
DESCRIPTION
tcpbench is a small tool that performs throughput benchmarking and
concurrent sampling of kernel network variables.
tcpbench is run as a client/server pair. The server must be invoked with
the -s flag, which will cause it to listen for incoming connections. The
client must be invoked with the hostname of a listening server to connect
to.
Once connected, the client will send TCP traffic as fast as possible to
the server. Both the client and server will periodically display
throughput statistics along with any kernel variables the user has
selected to sample (using the -k option). A list of available kernel
variables may be obtained using the -l option.
The options are as follows:
-B buf Specify the size of the internal read/write buffer used by
tcpbench. The default is 262144 bytes.
-k kvars
Specify one or more kernel variables to monitor; multiple
variables must be separated with commas. The default is not to
monitor any variables. Using this option requires read access to
/dev/kmem.
-l List the name of kernel variables available for monitoring and
exit.
-n connections
Use the given number of TCP connections (default: 1).
-p port
Specify the port used for the TCP test stream (default: 12345).
-r rate
Specify the statistics reporting rate in milliseconds (default:
1000).
-S space
Set the size of the socket buffer used for the TCP test stream.
On the client this option will resize the send buffer; on the
server it will resize the receive buffer.
-s Place tcpbench in server mode, where it will listen on all
interfaces for incoming connections.
-V rtable
Set the routing table to be used. The default is 0.
-v Display verbose output. If specified more than once, increase
the detail of information displayed.
SEE ALSOnetstat(1), pstat(8)HISTORY
The tcpbench program first appeared in OpenBSD 4.4.
AUTHORS
The tcpbench program was written by Damien Miller <djm@openbsd.org>.
OpenBSD 4.9 October 26, 2010 OpenBSD 4.9