2014-03-01 01:44:12 +04:00
|
|
|
iperf3: A TCP, UDP, and SCTP network bandwidth measurement tool
|
|
|
|
================================================================
|
2007-08-30 01:57:27 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
Summary
|
|
|
|
-------
|
2007-08-30 01:57:27 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
iperf is a tool for active measurements of the maximum achievable
|
|
|
|
bandwidth on IP networks. It supports tuning of various parameters
|
|
|
|
related to timing, protocols, and buffers. For each test it reports
|
2017-05-24 20:50:44 +03:00
|
|
|
the measured throughput / bitrate, loss, and other parameters.
|
2007-08-30 01:57:27 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
This version, sometimes referred to as iperf3, is a redesign of an
|
|
|
|
original version developed at NLANR/DAST. iperf3 is a new
|
|
|
|
implementation from scratch, with the goal of a smaller, simpler code
|
|
|
|
base, and a library version of the functionality that can be used in
|
2017-03-15 00:58:22 +03:00
|
|
|
other programs. iperf3 also has a number of features found in other tools
|
2014-03-01 01:44:12 +04:00
|
|
|
such as nuttcp and netperf, but were missing from the original iperf.
|
2014-03-01 05:52:52 +04:00
|
|
|
These include, for example, a zero-copy mode and optional JSON output.
|
2014-09-15 22:00:08 +04:00
|
|
|
Note that iperf3 is *not* backwards compatible with the original iperf.
|
2009-12-02 05:08:47 +03:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
Primary development for iperf3 takes place on CentOS Linux, FreeBSD,
|
2017-06-26 20:35:00 +03:00
|
|
|
and macOS. At this time, these are the only officially supported
|
2014-03-01 01:44:12 +04:00
|
|
|
platforms, however there have been some reports of success with
|
2015-06-19 20:51:57 +03:00
|
|
|
OpenBSD, NetBSD, Android, Solaris, and other Linux distributions.
|
2009-12-02 05:08:47 +03:00
|
|
|
|
2014-08-27 01:31:23 +04:00
|
|
|
iperf3 is principally developed by ESnet / Lawrence Berkeley National
|
2014-03-01 05:52:52 +04:00
|
|
|
Laboratory. It is released under a three-clause BSD license.
|
2014-03-01 01:44:12 +04:00
|
|
|
|
2014-05-06 02:28:05 +04:00
|
|
|
For more information see: http://software.es.net/iperf
|
|
|
|
|
|
|
|
Source code and issue tracker: https://github.com/esnet/iperf
|
2014-03-01 01:44:12 +04:00
|
|
|
|
|
|
|
Obtaining iperf3
|
|
|
|
----------------
|
|
|
|
|
|
|
|
Downloads of iperf3 are available at:
|
|
|
|
|
2014-06-11 03:05:33 +04:00
|
|
|
http://downloads.es.net/pub/iperf/
|
2014-03-01 01:44:12 +04:00
|
|
|
|
2015-06-19 20:51:57 +03:00
|
|
|
To check out the most recent code, clone the git repository at:
|
2014-03-01 01:44:12 +04:00
|
|
|
|
2015-06-19 20:51:57 +03:00
|
|
|
https://github.com/esnet/iperf.git
|
2014-03-01 01:44:12 +04:00
|
|
|
|
|
|
|
Building iperf3
|
|
|
|
---------------
|
|
|
|
|
|
|
|
### Prerequisites: ###
|
2014-04-11 02:07:49 +04:00
|
|
|
|
|
|
|
None.
|
2009-12-02 05:08:47 +03:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
### Building ###
|
2010-07-09 02:41:22 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
./configure; make; make install
|
2010-07-09 02:41:22 +04:00
|
|
|
|
2014-03-01 05:52:52 +04:00
|
|
|
(Note: If configure fails, try running `./bootstrap.sh` first)
|
2010-07-09 02:41:22 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
Invoking iperf3
|
|
|
|
---------------
|
2010-07-09 02:41:22 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
iperf3 includes a manual page listing all of the command-line options.
|
|
|
|
The manual page is the most up-to-date reference to the various flags and parameters.
|
2010-07-09 02:41:22 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
For sample command line usage, see:
|
|
|
|
|
2017-06-20 19:43:13 +03:00
|
|
|
https://fasterdata.es.net/performance-testing/network-troubleshooting-tools/iperf/
|
2010-07-09 02:41:22 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
Using the default options, iperf is meant to show typical well
|
2017-06-26 20:35:00 +03:00
|
|
|
designed application performance. "Typical well designed application"
|
2014-03-01 01:44:12 +04:00
|
|
|
means avoiding artificial enhancements that work only for testing
|
|
|
|
(such as splice()'ing the data to /dev/null). iperf does also have
|
2017-06-26 20:35:00 +03:00
|
|
|
flags for "extreme best case" optimizations, but they must be
|
2014-03-01 01:44:12 +04:00
|
|
|
explicitly activated.
|
|
|
|
|
|
|
|
These flags include:
|
2014-03-13 01:04:14 +04:00
|
|
|
|
|
|
|
-Z, --zerocopy use a 'zero copy' sendfile() method of sending data
|
|
|
|
-A, --affinity n/n,m set CPU affinity
|
2014-03-01 01:44:12 +04:00
|
|
|
|
|
|
|
Bug Reports
|
|
|
|
-----------
|
2013-11-10 21:37:10 +04:00
|
|
|
|
2014-09-15 22:00:08 +04:00
|
|
|
Before submitting a bug report, please make sure you're running the
|
|
|
|
latest version of the code, and confirm that your issue has not
|
|
|
|
already been fixed. Then submit to the iperf3 issue tracker on
|
|
|
|
GitHub:
|
|
|
|
|
2014-02-28 09:56:53 +04:00
|
|
|
https://github.com/esnet/iperf/issues
|
2013-11-10 21:37:10 +04:00
|
|
|
|
2014-09-15 22:00:08 +04:00
|
|
|
In your issue submission, please indicate the version of iperf3 and
|
|
|
|
what platform you're trying to run on (provide the platform
|
|
|
|
information even if you're not using a supported platform, we
|
|
|
|
*might* be able to help anyway). Exact command-line arguments will
|
|
|
|
help us recreate your problem. If you're getting error messages,
|
|
|
|
please include them verbatim if possible, but remember to sanitize any
|
|
|
|
sensitive information.
|
|
|
|
|
|
|
|
If you have a question about usage or about the code, please do *not*
|
|
|
|
submit an issue. Please use one of the mailing lists for that.
|
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
Changes from iperf 2.x
|
|
|
|
----------------------
|
2013-11-10 21:37:10 +04:00
|
|
|
|
2017-11-17 21:48:05 +03:00
|
|
|
(Note that iperf2 is no longer being developed by its original
|
|
|
|
maintainers. However, beginning in 2014, another developer began
|
|
|
|
fixing bugs and enhancing functionality, and generating releases of
|
|
|
|
iperf2. Both projects (as of late 2017) are currently being developed
|
|
|
|
actively, but independently. The continuing iperf2 development
|
|
|
|
project can be found at https://sourceforge.net/projects/iperf2/.)
|
|
|
|
|
2013-11-10 21:37:10 +04:00
|
|
|
New options:
|
2014-01-08 21:28:49 +04:00
|
|
|
|
2014-03-13 01:04:14 +04:00
|
|
|
-V, --verbose more detailed output than before
|
|
|
|
-J, --json output in JSON format
|
|
|
|
-Z, --zerocopy use a 'zero copy' sendfile() method of sending data
|
|
|
|
-O, --omit N omit the first n seconds (to ignore slowstart)
|
|
|
|
-T, --title str prefix every output line with this string
|
|
|
|
-F, --file name xmit/recv the specified file
|
|
|
|
-A, --affinity n/n,m set CPU affinity (Linux and FreeBSD only)
|
|
|
|
-k, --blockcount #[KMG] number of blocks (packets) to transmit (instead
|
|
|
|
of -t or -n)
|
|
|
|
-L, --flowlabel set IPv6 flow label (Linux only)
|
2014-01-08 04:45:43 +04:00
|
|
|
|
|
|
|
Changed flags:
|
2014-03-13 01:04:14 +04:00
|
|
|
|
|
|
|
-C, --linux-congestion set congestion control algorithm (Linux only)
|
|
|
|
(-Z in iperf2)
|
2013-11-10 21:37:10 +04:00
|
|
|
|
|
|
|
|
2014-01-08 04:45:43 +04:00
|
|
|
Deprecated options:
|
2013-11-10 21:37:10 +04:00
|
|
|
|
2014-01-08 21:28:49 +04:00
|
|
|
Not planning to support these iperf2 flags. If you really miss these
|
|
|
|
options, please submit a request in the issue tracker:
|
|
|
|
|
2014-03-13 01:04:14 +04:00
|
|
|
-d, --dualtest Do a bidirectional test simultaneously
|
|
|
|
-r, --tradeoff Do a bidirectional test individually
|
|
|
|
-T, --ttl time-to-live, for multicast (default 1)
|
|
|
|
-x, --reportexclude [CDMSV] exclude C(connection) D(data) M(multicast)
|
|
|
|
S(settings) V(server) reports
|
|
|
|
-y, --reportstyle C report as a Comma-Separated Values
|
2013-11-10 21:37:10 +04:00
|
|
|
|
2014-01-08 21:28:49 +04:00
|
|
|
Also deprecated is the ability to set the options via environment
|
|
|
|
variables.
|
2013-11-10 21:37:10 +04:00
|
|
|
|
2014-03-01 01:44:12 +04:00
|
|
|
Known Issues
|
|
|
|
------------
|
2013-12-19 03:23:16 +04:00
|
|
|
|
2017-02-25 02:55:45 +03:00
|
|
|
A set of known issues is maintained on the iperf3 Web pages:
|
|
|
|
|
|
|
|
http://software.es.net/iperf/dev.html#known-issues
|
2015-11-18 21:26:05 +03:00
|
|
|
|
2014-08-27 01:31:23 +04:00
|
|
|
Links
|
|
|
|
-----
|
|
|
|
|
|
|
|
This section lists links to user-contributed Web pages regarding
|
|
|
|
iperf3. ESnet and Lawrence Berkeley National Laboratory bear no
|
|
|
|
responsibility for the content of these pages.
|
|
|
|
|
|
|
|
* Installation instructions for Debian Linux (by Cameron Camp
|
|
|
|
<cameron@ivdatacenter.com>):
|
|
|
|
|
|
|
|
http://cheatsheet.logicalwebhost.com/iperf-network-testing/
|
2014-09-30 01:00:46 +04:00
|
|
|
|
|
|
|
Copyright
|
|
|
|
---------
|
|
|
|
|
2017-01-07 08:19:27 +03:00
|
|
|
iperf, Copyright (c) 2014-2017, The Regents of the University of
|
2014-09-30 01:00:46 +04:00
|
|
|
California, through Lawrence Berkeley National Laboratory (subject
|
|
|
|
to receipt of any required approvals from the U.S. Dept. of
|
|
|
|
Energy). All rights reserved.
|
|
|
|
|
|
|
|
If you have questions about your rights to use or distribute this
|
|
|
|
software, please contact Berkeley Lab's Technology Transfer
|
|
|
|
Department at TTD@lbl.gov.
|
|
|
|
|
|
|
|
NOTICE. This software is owned by the U.S. Department of Energy.
|
|
|
|
As such, the U.S. Government has been granted for itself and others
|
|
|
|
acting on its behalf a paid-up, nonexclusive, irrevocable,
|
|
|
|
worldwide license in the Software to reproduce, prepare derivative
|
|
|
|
works, and perform publicly and display publicly. Beginning five
|
|
|
|
(5) years after the date permission to assert copyright is obtained
|
|
|
|
from the U.S. Department of Energy, and subject to any subsequent
|
|
|
|
five (5) year renewals, the U.S. Government is granted for itself
|
|
|
|
and others acting on its behalf a paid-up, nonexclusive,
|
|
|
|
irrevocable, worldwide license in the Software to reproduce,
|
|
|
|
prepare derivative works, distribute copies to the public, perform
|
|
|
|
publicly and display publicly, and to permit others to do so.
|
|
|
|
|
|
|
|
This code is distributed under a BSD style license, see the LICENSE
|
|
|
|
file for complete information.
|