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 rdomain] hostname
     tcpbench -s [-v] [-B buf] [-k kvars] [-p port] [-r rate] [-S space]
              [-V rdomain]

DESCRIPTION
     tcpbench is a small tool that performs throughput benchmarking and con-
     current 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 se-
     lected to sample (using the -k option).  A list of available kernel vari-
     ables 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 vari-
             ables must be separated with commas.  The default is not to moni-
             tor 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 inter-
             faces for incoming connections.

     -V rdomain
             Set the routing domain.  The default is 0.

     -v      Display verbose output.  If specified more than once, increase
             the detail of information displayed.

SEE ALSO
     netstat(1), pstat(8)

OpenBSD 4.7                     August 13, 2009                              2
