TCPBENCH(1) FreeBSD General Commands Manual TCPBENCH(1)
NAME
tcpbench - TCP/UDP benchmarking and measurement tool
SYNOPSIS
tcpbench -l
tcpbench [-46cDRUuv] [-B buf] [-b sourceaddr] [-k kvars] [-n connections]
[-p port] [-r interval] [-S space] [-T keyword] [-t secs]
[-V rtable] hostname
tcpbench -s [-46cDUuv] [-B buf] [-C certfile -K keyfile] [-k kvars]
[-p port] [-r interval] [-S space] [-T keyword] [-V rtable]
[hostname]
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 or UDP traffic as fast as
possible to the server. Both the client and server will periodically
compute and display throughput statistics. The server starts computing
these for UDP on receipt of the first datagram, and stops for TCP when it
has no connections. This display also includes any kernel variables the
user has selected to sample (using the -k option, which is only available
in TCP mode). A list of available kernel variables may be obtained using
the -l option.
A summary over the periodic throughput statistics is displayed on exit.
Its accuracy may be increased by decreasing the interval. The summary
bytes and duration cover the interval from transfer start to process
exit. The summary information can also be displayed while tcpbench is
running by sending it a SIGINFO signal (see the status argument of
stty(1) for more information).
The options are as follows:
-4 Force tcpbench to use IPv4 addresses only.
-6 Force tcpbench to use IPv6 addresses only.
-B buf Specify the size of the internal read/write buffer used by
tcpbench. The default is 262144 bytes for TCP client/server and
UDP server. In UDP client mode this may be used to specify the
packet size on the test stream.
-b sourceaddr
Specify the IP address to send the packets from, which is useful
on machines with multiple interfaces.
-C certfile
Load the public key part of the TLS peer certificate from
certfile, in PEM format. Requires -s and -c.
-c Use TLS to connect or listen.
-D Enable debugging on the socket.
-K keyfile
Load the TLS private key from keyfile, in PEM format. Requires
-s and -c.
-k kvars
Specify one or more kernel variables to monitor; multiple
variables must be separated with commas. This option is only
valid in TCP mode. The default is not to monitor any variables.
-l List the name of kernel variables available for monitoring and
exit.
-n connections
Use the given number of TCP connections (default: 1). UDP is
connectionless so this option isn't valid.
-p port
Specify the port used for the test stream (default: 12345).
-R In client mode the write buffer size is randomized up to the size
specified via -B.
-r interval
Specify the statistics interval reporting rate in milliseconds
(default: 1000). If set to 0, nothing is printed.
-S space
Set the size of the socket buffer used for the 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. It defaults to using TCP if
-u is not specified.
-T keyword
Change the IPv4 TOS or IPv6 TCLASS value. keyword may be one of
critical, inetcontrol, lowdelay, netcontrol, throughput,
reliability, or one of the DiffServ Code Points: ef, af11 ...
af43, cs0 ... cs7; or a number in either hex or decimal.
For TLS options, keyword specifies a value in the form of a
key=value pair: ciphers, which allows the supported TLS ciphers
to be specified (see tls_config_set_ciphers(3) for further
details) or protocols, which allows the supported TLS protocols
to be specified (see tls_config_parse_protocols(3) for further
details). Specifying TLS options requires -c.
-t secs
Stop after secs seconds.
-U Use AF_UNIX sockets instead of IPv4 or IPv6 sockets. In client
and server mode hostname is used as the path to the AF_UNIX
socket.
-u Use UDP instead of TCP; this must be specified on both the client
and the server. Transmitted packets per second (TX PPS) will be
accounted on the client side, while received packets per second
(RX PPS) will be accounted on the server side. UDP has no
Protocol Control Block (PCB) so the -k flags don't apply.
-V rtable
Set the routing table to be used.
-v Display verbose output. If specified more than once, increase
the detail of information displayed.
SEE ALSO
netstat(1), pstat(8)
HISTORY
The tcpbench program first appeared in OpenBSD 4.4.
AUTHORS
The tcpbench program was written by Damien Miller <
[email protected]>.
UDP mode and libevent port by Christiano F. Haesbaert
<
[email protected]>.
FreeBSD 14.1-RELEASE-p8 November 6, 2024 FreeBSD 14.1-RELEASE-p8