| == iperf 3.1.6 2017-02-02 == |
| |
| The release notes for iperf 3.1.6 describe changes, including bug |
| fixes and new functionality, made since iperf 3.1.5. |
| |
| * User-visible changes |
| |
| * Specifying --fq-rate or --no-fq-socket-pacing on a system where |
| these options are not supported now generate an error instead of a |
| warning. This change makes diagnosing issues related to pacing |
| more apparent. |
| |
| * Fixed a bug where two recently-added diagnostic messages spammed |
| the JSON output on UDP tests. |
| |
| == iperf 3.1.5 2017-01-12 == |
| |
| The release notes for iperf 3.1.5 describe changes, including bug |
| fixes and new functionality, made since iperf 3.1.4. |
| |
| Compatibility note: Fair-queueing is now specified differently in |
| iperf 3.1.5 than in prior versions (which include 3.1.3 and 3.1.4). |
| |
| Compatibility note: UDP tests may yield different results from all |
| prior versions of iperf3 (through 3.1.4) due to the new default UDP |
| sending size. |
| |
| * User-visible changes |
| |
| * The fair-queueing per-socket based pacing available on recent |
| Linux systems has been reimplemented with a different user |
| interface (#325, #467, #488). The --bandwidth command-line flag |
| now controls only the application-level pacing, as was the case in |
| iperf 3.1.2 and all earlier versions. Fair-queueing per-socket |
| based pacing is now controlled via a new --fq-rate command-line |
| flag. Note that TCP and UDP tests may use --bandwidth, --fq-rate, |
| both flags, or neither flag. SCTP tests currently support |
| --bandwidth only. The --no-fq-socket-pacing flag, which was |
| introduced in iperf 3.1.3, has now been deprecated, and is |
| equivalent to --fq-rate=0. iperf3 now reacts more gracefully if |
| --no-fq-socket-pacing or --fq-rate are specified on platforms that |
| don't support these options. |
| |
| For UDP tests, note that the default --bandwidth is 1 Mbps. Using |
| the fair-queueing-based pacing will probably require explicitly |
| setting both --bandwidth and --fq-rate, preferably to the same |
| value. (While setting different values for --bandwidth and |
| --fq-rate can certainly be done, the results can range from |
| entertaining to perplexing.) |
| |
| * iperf3 now chooses a more sane default UDP send size (#496, #498). |
| The former default (8KB) caused IP packet fragmentation on paths |
| having smaller MTUs (including any Ethernet network not configured |
| for jumbo frames). This could have effects ranging from increased |
| burstiness, to packet loss, to complete failure of the test. |
| iperf3 now attempts to use the MSS of the control connection to |
| determine a default UDP send size if no sending length was |
| explicitly specified with --length. |
| |
| * Several checks are now made when setting the socket buffer sizes |
| with the -w option, to verify that the settings have been applied |
| correctly. The results of these checks can been seen when the |
| --debug flag is specified. (#356) |
| |
| * A --forceflush flag has been added to flush the output stream |
| after every statistics reporting interval. |
| |
| * Developer-visible changes |
| |
| * A systemd service file has been added (#340, #430). |
| |
| == iperf 3.1.4 2016-10-31 == |
| |
| The release notes for iperf 3.1.4 describe changes, including bug |
| fixes and new functionality, made since iperf 3.1.3. |
| |
| * User-visible changes |
| |
| * On systems that support setting the congestion control algorithm, |
| iperf3 now keeps track of the congestion control algorithm and |
| print it in the JSON output in the members sender_tcp_congestion |
| and receiver_tcp_congestion (issue #461). A few bugs (probably |
| not user-visible) with setting the congestion control algorithm |
| were also fixed. |
| |
| * Developer-visible changes |
| |
| * Fixed a buffer overflow in the cJSON library (issue #466). It is |
| not believed that this bug created any security vulnerabilities in |
| the context of iperf3. |
| |
| * Travis CI builds are now enabled on this codeline (pull request #424). |
| |
| * Various bug fixes (issue #459, pull request #429, issue #388). |
| |
| == iperf 3.1.3 2016-06-08 == |
| |
| The release notes for iperf 3.1.3 describe changes, including bug |
| fixes and new functionality, made since iperf 3.1.2. |
| |
| * Security |
| |
| * Fixed a buffer overflow / heap corruption issue that could occur |
| if a malformed JSON string was passed on the control channel. In |
| theory, this vulnerability could be leveraged to create a heap |
| exploit. This issue, present in the cJSON library, was already |
| fixed upstream, so was addressed in iperf3 by importing a newer |
| version of cJSON (plus local ESnet modifications). Discovered and |
| reported by Dave McDaniel, Cisco Talos. Cross-references: |
| TALOS-CAN-0164, ESNET-SECADV-2016-0001, CVE-2016-4303. |
| |
| * User-visible changes |
| |
| * On supported platforms (recent Linux), iperf3 can use |
| fair-queueing-based per-socket pacing instead of its own |
| application-level pacing for the --bandwidth option. |
| Application-level pacing can be forced with the |
| -no-fq-socket-pacing flag. |
| |
| * A bug that could show negative loss counters with --udp and --omit |
| has been fixed (issue #412, pull request #414). |
| |
| * Error handling has been made slightly more robust. Also, the |
| iperf3 server will no longer exit after five consecutive errors, |
| but will only exit for certain types of errors that prevent it |
| from participating in any tests at all. |
| |
| * Developer-visible changes |
| |
| * Fixed the build on FreeBSD 11-CURRENT (issue #413). |
| |
| * Fixed various coding errors (issue #423, issue #425). |
| |
| == iperf 3.1.2 2016-02-01 == |
| |
| The release notes for iperf 3.1.2 describe changes, including bug |
| fixes and new functionality, made since iperf 3.1.1. |
| |
| * User-visible changes |
| |
| * Fixed a bug that caused nan values to be emitted (incorrectly) |
| into JSON, particularly at the end of UDP tests (issue #278). |
| |
| * Fixed a bug that caused the wrong value to be printed for |
| out-of-order UDP packets (issue #329). |
| |
| * Added a contrib/ directory containing a few submitted graphing |
| scripts. |
| |
| * Developer-visible changes |
| |
| == iperf 3.1.1 2015-11-19 == |
| |
| The release notes for iperf 3.1.1 describe changes and new |
| functionality in iperf 3.1.1, but not present in 3.1. |
| |
| * User-visible changes |
| |
| * Some markup fixes have been made in the manpages for Debian |
| compatibility (issue #291). |
| |
| * A bug where the -T title option was not being output correctly |
| in JSON output has been fixed (issue #292). |
| |
| * Argument handling for some command-line options has been improved |
| (issue #316). |
| |
| * Developer-visible changes |
| |
| * A regression with C++ compatibility in one of the iperf header |
| files has been fixed (issue #323). |
| |
| == iperf 3.1 2015-10-16 == |
| |
| The release notes for iperf 3.1 describe changes and new |
| functionality in iperf 3.1, but not present in 3.0.11 or any earlier |
| 3.0.x release. |
| |
| * Selected user-visible changes |
| |
| * SCTP support has been added (with the --sctp flag), on Linux, |
| FreeBSD, and Solaris (issue #131). |
| |
| * Setting CPU affinity now works on FreeBSD. |
| |
| * Selection of TCP congestion now works on FreeBSD, and is now |
| called --congestion (the old --linux-congestion option works |
| but is now deprecated). |
| |
| * A new -I option for the server causes it to write a PID file, |
| mostly useful for daemon mode (issue #120). |
| |
| * A --logfile argument can now force all output to go to a file, |
| rather than to a file. This is especially useful when running an |
| iperf3 server in daemon mode (issue #119). |
| |
| * Various compatibility fixes for Android (issue #184, issue #185), |
| iOS (issue #288), NetBSD (issue #248), Solaris (issue #175, issue |
| #178, issue #180, issue #211), vxWorks (issue #268). |
| |
| * A --udp-counters-64bit flag has been added to support very |
| long-running UDP tests, which could cause a counter to overflow |
| (issue #191). |
| |
| * A --cport option to specify the client-side port has been added |
| (issue #207, issue #209, issue #239). |
| |
| * Some calculation errors with the -O feature have been fixed (issue |
| #236). |
| |
| * A potential crash in the iperf3 server has been fixed (issue #257, |
| issue #258). |
| |
| * Many miscellaneous bug fixes. |
| |
| * Selected developer-visible changes |
| |
| * Consumers of libiperf can now get the JSON output for a |
| just-completed test (issue #147). |
| |
| * Detection of various optional features has been improved to check |
| for the presence or absence of platform functionality, not the name |
| of platforms. |
| |
| * Out-of-tree builds now work (issue #265). |
| |
| == iperf 3.0.11 2015-01-09 == |
| |
| * User-visible changes |
| |
| * Added -1 / --one-off flag, which causes the iperf3 server to |
| process one client connection and then exit. Intended primarily |
| for bwctl integration (issue #230). |
| |
| * Added various minor bug fixes (issues #231, #232, #233). |
| |
| * Added 30-second timeout for UDP tests if unable to establish UDP |
| connectivity between sender and receiver (issue #222). |
| |
| == iperf 3.0.10 2014-12-16 == |
| |
| * User-visible changes |
| |
| * Fixed the build on MacOS X Yosemite (issue #213). |
| |
| * UDP tests now honor the -w option for setting the socket buffer |
| sizes (issue #219). |
| |
| * Developer-visible changes |
| |
| * Added an RPM spec file plus functionality to fill in the version |
| number. |
| |
| * Fixed potential filename collision with a system header (issue |
| #203). |
| |
| == iperf 3.0.9 2014-10-14 == |
| |
| * User-visible changes |
| |
| * Fixed a series of problems that came from attempting a UDP test |
| with a pathologically large block size. This put the server into |
| an odd state where it could not accept new client connections. |
| This in turn caused subsequent client connections to crash when |
| interrupted (issue #212). |
| |
| * Developer-visible changes |
| |
| * None. |
| |
| == iperf 3.0.8 2014-09-30 == |
| |
| * User-visible changes |
| |
| * Updated license and copyright verbage to confirm to LBNL Tech |
| Transfer requirements. No substantive changes; license remains |
| the 3-clause BSD license. |
| |
| * Developer-visible changes |
| |
| * None. |
| |
| == iperf 3.0.7 2014-08-28 == |
| |
| * User-visible changes |
| |
| * A server bug where new connections from clients could disrupt |
| running tests has been fixed (issue #202). |
| |
| * Rates now consistently use 1000-based prefixes (K, M, G), where |
| sizes of objects now consistently use 1024-based prefixes (issue #173). |
| |
| * UDP tests with unlimited bandwidth are now supported (issue #170). |
| |
| * An interaction between the -w and -B options, which kept them from |
| working when used together, has been fixed (issue #193). |
| |
| * Developer-visible changes |
| |
| == iperf 3.0.6 2014-07-28 == |
| |
| * User-visible changes |
| |
| * Several bugs that kept the -B option from working in various |
| circumstances have been fixed (issue #193). |
| |
| * Various compatibility fixes for OpenBSD (issue #196) and |
| Solaris (issue #177). |
| |
| * Developer-visible changes |
| |
| * The {get,set}_test_bind_address API calls have been added to |
| expose the -B functionality to API consumers (issue #197). |
| |
| == iperf 3.0.5 2014-06-16 == |
| |
| * User-visible changes |
| |
| * Erroneous output when doing --json output has been fixed (this |
| problem was caused by an attempt to fix issue #158). |
| |
| * The maximum test running time has been increased from one hour to |
| one day (issue #166). |
| |
| * Project documentation has been moved to GitHub Pages at this URL: |
| http://software.es.net/iperf/. |
| |
| * A bug that caused CPU time to be computed incorrectly on FreeBSD |
| has been fixed. |
| |
| * A timing issue which caused measurement intervals to be wrong |
| with TCP tests on lossy networks has been fixed (issue #125). |
| |
| * Newer versions of autoconf / automake / libtool are now used by |
| default (issue #161). |
| |
| * JSON output now indicates whether the test was run in --reverse |
| mode (issue #167). |
| |
| * It is now possible to get (most of) the server-side output at |
| the client by using the --get-server-output flag (issue #160). |
| |
| * Developer-visible changes |
| |
| * automake/autoconf/libtool have been updated to more recent |
| versions. AM_MAINTAINER_MODE is now used to avoid requiring these |
| tools at build-time. |
| |
| == iperf 3.0.4 was not released == |
| |
| == iperf 3.0.3 2014-03-26 == |
| |
| * User-visible changes |
| |
| * Due to several oversights, the source code archive for iperf 3.0.2 |
| was distributed as an uncompressed tarball, despite having an |
| extension (".tar.gz") that indicated it was compressed. The |
| release generation procedure has been changed to avoid this |
| problem going forward. |
| |
| * Summary structures in the JSON output are now included, even if |
| there is only one stream. This change makes consuming the JSON |
| output easier and more consistent (issue #151). |
| |
| * A possible buffer overflow in iperf_error.c has been fixed (issue |
| #155). |
| |
| * Developer-visible changes |
| |
| * Example programs now build correctly, after having been broken in |
| the 3.0.2 release (issue #152). |
| |
| == iperf 3.0.2 2014-03-10 == |
| |
| * User-visible changes |
| |
| * The iperf3 project has been moved to GitHub, and various URLs in |
| documentation files have been changed to point there. |
| |
| * iperf3 now builds on Linux systems that do not support |
| TCP_CONGESTION. Most notably this allows iperf3 to work on CentOS |
| 5. |
| |
| * An abort on MacOS 10.9 has been fixed (issue #135). |
| |
| * Added -I flag for the server to write a PID file, mostly useful for |
| daemon mode (issue #120). |
| |
| * A bug that could break some TCP tests on FreeBSD has been fixed. |
| |
| * TCP snd_cwnd output is now printed by default on Linux (issue #99). |
| |
| * In JSON output, the --title string no longer has a colon and two |
| spaces appended (issue #139). |
| |
| * A buffer for holding formatted numeric values is now |
| properly-sized so that output is not truncated (issue #142). |
| |
| * Developer-visible changes |
| |
| * Some memory leaks have been fixed. |
| |
| * A -d flag enables debugging output. |
| |
| * A .gitignore file has been added. |
| |
| * libtoolize is now invoked correctly from the bootstrap.sh script. |
| |
| * The test unit format can now be set from the API (issue #144). |
| |
| * libiperf is now built as both shared and static libraries. |
| |
| * In the JSON output, the "connection" structures are now stored as |
| an array in the "start" block, instead of overwriting each other. |
| While technically an incompatible API change, the former behavior |
| generated unusable JSON. |
| |
| == iperf 3.0.1 2014-01-10 == |
| * Added the following new flags |
| -D, --daemon run server as a daemon |
| -L, --flowlabel set IPv6 flow label (Linux only) |
| -C, --linux-congestion set congestion control algorithm (Linux only) |
| -k, --blockcount #[KMG] number of blocks (packets) to transmit |
| (instead of -t or -n) |
| * Bug fixes |
| |
| == iperf 3.0-RC5 2013-11-15 == |
| * Added the following new flags |
| -F, --file name xmit/recv the specified file |
| -A, --affinity n/n,m set CPU affinity (Linux only) |
| -J, --json output in JSON format |
| -Z, --zerocopy use a 'zero copy' method of sending data |
| -O, --omit N omit the first n seconds |
| -T, --title str prefix every output line with this string |
| * more useful information in 'verbose' mode |
| * Many bug fixes |
| |
| |
| == iperf 3.0b4 2010-08-02 == |
| |
| * Added support for binding to a specific interface (-B) |
| * Added support for IPv6 mode (-6) |
| * Setting TCP window size (-w) is now supported |
| * Updates to iperf_error |
| * Added new errors |
| * Should generate more relavent messages |
| * Stream list now managed by queue.h macros |
| * Test structures are now kept intact after a test is run (for API users) |
| * Improved interval timer granularity |
| * Support for decimal values |
| * Many bug fixes |
| |
| == iperf 3.0b3 2010-07-23 == |
| |
| * Better error handling |
| * All errors now handled with iperf_error() |
| * All functions that can return errors return NULL or -1 on error and set i_errno appropriately |
| * Iperf API intruduced |
| * Support for adding new protocols |
| * Added support for callback functions |
| * on_connect - executes after a connection is made to the server |
| * on_new_stream - executes after a new stream is created |
| * on_test_start - executes right before the test begins |
| * on_test_finish - executes after the test is finished |
| * Added early support for verbose mode (-V) |
| |
| == iperf 3.0b2 2010-07-15 == |
| |
| * UDP mode now supported |
| * Support for setting bandwidth (-b) |
| * Parallel UDP stream support |
| * Reverse mode UDP support |
| * Support for setting TCP_NODELAY (-N), disabling Nagle's Algorithm |
| * Support for setting TCP MSS (-M) |
| * Note: This feature is still in development. It is still very buggy. |
| |
| == iperf 3.0b1 2010-07-08 == |
| |
| * TCP control socket now manages messages between client and server |
| * Dynamic server (gets test parameters from client) |
| * Server can now set test options dynamically without having to restart. |
| * Currently supported options: -l, -t, -n, -P, -R |
| * Future options: -u, -b, -w, -M, -N, -I, -T, -Z, -6 |
| * Results exchange |
| * Client can now see server results (and vice versa) |
| * Reverse mode (-R) |
| * Server sends, client receives |
