| commit | 10e2cc241e46619c5ec9a4bc02564fa4f5daa5de | [log] [tgz] |
|---|---|---|
| author | Bruce A. Mah <bmah@kitchenlab.org> | Wed May 03 10:21:34 2017 -0700 |
| committer | GitHub <noreply@github.com> | Wed May 03 10:21:34 2017 -0700 |
| tree | e04ed5c134dea850ed48ad7787c9b2908dcf9f3b | |
| parent | c8531ca31fab4be1a02d4d3bf86fa555048e9805 [diff] |
Fix various problems with summary statistics (#562) * Untangle some problems with printing summary statistics. There were (at least) two problems: o The server cannot print summary statistics as seen from the client, because the server has to generate its summaries before receiving any statistics from the client. This shortcoming is somewhat hard-coded into the semantics of messages on the control channel, and probably can't be easily changed. o UDP summary statistics for each stream were ambiguous in that it wasn't clear whether they were intended to apply to the sender or receiver. To fix this, we split UDP summary statistics into two lines, one for the sender side and one for the receiver side. This hopefully eliminates any ambiguity about the statistics. On the server, we don't attempt to print the (not very meaningful and potentially misleading) statistics corresponding to the client. Possible fix for #560. * Try to report more accurate ending statistics. Basically the client side was using only its measured test duration to compute figures such as bitrate, but the server's test duration could be different due to network delays/jitter. So we make sure that the test durations (for each stream) are passed in the test results and used appropriately when we print statistics for the sender and receiver. Towards #560, also this could help towards #238. * Silence a warning over an uninitialized variable.
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 the bandwidth, loss, and other parameters.
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 other programs. iperf3 also has a number of features found in other tools such as nuttcp and netperf, but were missing from the original iperf. These include, for example, a zero-copy mode and optional JSON output. Note that iperf3 is not backwards compatible with the original iperf.
Primary development for iperf3 takes place on CentOS Linux, FreeBSD, and MacOS X. At this time, these are the only officially supported platforms, however there have been some reports of success with OpenBSD, NetBSD, Android, Solaris, and other Linux distributions.
iperf3 is principally developed by ESnet / Lawrence Berkeley National Laboratory. It is released under a three-clause BSD license.
Note that at this point, ESnet plans to support iperf3 in “maintenance mode”. At this point, there are no definite plans for further iperf3 releases, and ESnet will be providing a very limited amount of resources for support and development, going forward. However, ESnet could issue new iperf3 releases to deal with security issues or high-impact bug fixes.
For more information see: http://software.es.net/iperf
Source code and issue tracker: https://github.com/esnet/iperf
Downloads of iperf3 are available at:
http://downloads.es.net/pub/iperf/
To check out the most recent code, clone the git repository at:
https://github.com/esnet/iperf.git
None.
./configure; make; make install
(Note: If configure fails, try running ./bootstrap.sh first)
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.
For sample command line usage, see:
http://fasterdata.es.net/performance-testing/network-troubleshooting-tools/iperf-and-iperf3/
Using the default options, iperf is meant to show typical well designed application performance. ‘Typical well designed application’ means avoiding artificial enhancements that work only for testing (such as splice()'ing the data to /dev/null). iperf does also have flags for ‘extreme best case’ optimizations but they must be explicitly activated.
These flags include:
-Z, --zerocopy use a 'zero copy' sendfile() method of sending data -A, --affinity n/n,m set CPU affinity
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:
https://github.com/esnet/iperf/issues
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.
New options:
-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)
Changed flags:
-C, --linux-congestion set congestion control algorithm (Linux only)
(-Z in iperf2)
Deprecated options:
Not planning to support these iperf2 flags. If you really miss these options, please submit a request in the issue tracker:
-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
Also deprecated is the ability to set the options via environment variables.
A set of known issues is maintained on the iperf3 Web pages:
http://software.es.net/iperf/dev.html#known-issues
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):
iperf, Copyright (c) 2014-2017, The Regents of the University of 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.