xref: /iperf/docs/news.rst (revision 4c20d0d6) 
1iperf3 Project News
2===================
3
42022-01-28:  iperf-3.11 released
5----------------------------------
6| URL:  https://downloads.es.net/pub/iperf/iperf-3.11.tar.gz
7| SHA256:  ``de8cb409fad61a0574f4cb07eb19ce1159707403ac2dc01b5d175e91240b7e5f``
8
9iperf 3.11 is principally a bugfix release. Also GitHub
10Discussions are now supported.
11
12
132021-06-02:  iperf-3.10.1 released
14----------------------------------
15
16| URL:  https://downloads.es.net/pub/iperf/iperf-3.10.1.tar.gz
17| SHA256:  ``03bc9760cc54a245191d46bfc8edaf8a4750f0e87abca6764486972044d6715a  iperf-3.10.1.tar.gz``
18
19iperf 3.10.1 fixes a problem with the configure script that made it
20make not work correctly in some circumstances. It is functionally
21identical to iperf 3.10.
22
232021-05-26:  iperf-3.10 released
24--------------------------------
25
26| URL:  https://downloads.es.net/pub/iperf/iperf-3.10.tar.gz
27| SHA256:  ``4390982928542256c17d6dd1f56eede9092649ebfd8a97c8cecfad12d238ad57  iperf-3.10.tar.gz``
28
29iperf 3.10 is principally a bugfix release. A few new features have
30been added (``--time-skew-threshold``, ``--bind-dev``,
31``--rcv-timeout``, and ``--dont-fragment``).  More information on
32these new features can be found in the release notes.
33
342020-08-17:  iperf-3.9 released
35---------------------------------
36
37| URL:  https://downloads.es.net/pub/iperf/iperf-3.9.tar.gz
38| SHA256:  ``24b63a26382325f759f11d421779a937b63ca1bc17c44587d2fcfedab60ac038  iperf-3.9.tar.gz``
39
40iperf 3.9 adds a ``--timestamps`` flag, which prepends a timestamp to
41each output line.  A new ``--server-bitrate-limit`` flag has been
42added as a server command-line argument, and allows an iperf3 server
43to enforce a maximum throughput rate.  More information on these new
44features can be found in the release notes.
45
462020-06-10:  iperf-3.8.1 released
47---------------------------------
48
49| URL:  https://downloads.es.net/pub/iperf/iperf-3.8.1.tar.gz
50| SHA256:  ``e5b080f3273a8a715a4100f13826ac2ca31cc7b1315925631b2ecf64957ded96 iperf-3.8.1.tar.gz``
51
52iperf 3.8.1 fixes a regression with ``make install`` in iperf 3.8.  It
53is otherwise identical to iperf 3.8.
54
552020-06-08:  iperf-3.8 released
56-------------------------------
57
58| URL:  https://downloads.es.net/pub/iperf/iperf-3.8.tar.gz
59| SHA256:  ``edc1c317b0ae31925e5eb84f0295faefbaa1db3229f4693e11d954d114de4bcd  iperf-3.8.tar.gz``
60
61iperf 3.8 contains minor bugfixes and enhancements.
62
63
642019-06-21:  iperf-3.7 released
65-------------------------------
66
67| URL:  https://downloads.es.net/pub/iperf/iperf-3.7.tar.gz
68| SHA256:  ``d846040224317caf2f75c843d309a950a7db23f9b44b94688ccbe557d6d1710c  iperf-3.7.tar.gz``
69
70iperf 3.7 adds the ``--bidir`` flag for bidirectional tests, includes
71some minor enhancements, and fixes a number of bugs.  More details can
72be found in the release notes.
73
74Note:  Documentation for the ``--bidir`` flag was inadvertently
75omitted from the manual page.  This will be fixed in a future
76release.
77
782018-06-25:  iperf-3.6 released
79-------------------------------
80
81| URL:  https://downloads.es.net/pub/iperf/iperf-3.6.tar.gz
82| SHA256:  ``de5d51e46dc460cc590fb4d44f95e7cad54b74fea1eba7d6ebd6f8887d75946e  iperf-3.6.tar.gz``
83
84iperf 3.6 adds the ``--extra-data`` and ``--repeating-payload``
85options and fixes some minor bugs.
86
872018-03-02:  iperf-3.5 released
88-------------------------------
89
90| URL:  http://downloads.es.net/pub/iperf/iperf-3.5.tar.gz
91| SHA256:  ``539bd9ecdca1b8c1157ff85b70ed09b3c75242e69886fc16b54883b399f72cd5  iperf-3.5.tar.gz``
92
93iperf 3.5 fixes a bug that could over-count data transfers (and hence
94measured bitrate).
95
962018-02-14:  iperf-3.4 released
97-------------------------------
98
99| URL:  http://downloads.es.net/pub/iperf/iperf-3.4.tar.gz
100| SHA256:  ``71528332d751df85e046d1944d9a0269773cadd6e51840aecdeed30925f79111  iperf-3.4.tar.gz``
101
102iperf 3.4 fixes a number of minor bugs and adds a few enhancements.
103
1042017-10-31:  iperf-3.3 released
105-------------------------------
106
107| URL:  http://downloads.es.net/pub/iperf/iperf-3.3.tar.gz
108| SHA256:  ``6f596271251056bffc11bbb8f17d4244ad9a7d4a317c2459fdbb853ae51284d8  iperf-3.3.tar.gz``
109
110New minor release of iperf 3.3, fixing a number of minor bugs.
111
1122017-06-26:  iperf-3.2 released
113-------------------------------
114
115| URL:  http://downloads.es.net/pub/iperf/iperf-3.2.tar.gz
116| SHA256:  ``f207b36f861485845dbdf09f909c62f3d2222a3cf3d2682095aede8213cd9c1d  iperf-3.2.tar.gz``
117
118New minor release of iperf 3.2, with new features, bugfixes, and enhancements.
119
1202017-06-06:  iperf3 update, June 2017
121--------------------------------------
122
123https://raw.githubusercontent.com/esnet/iperf/master/docs/2017-06-06.txt
124
125
1262017-04-27:  iperf3 update, April 2017
127--------------------------------------
128
129https://raw.githubusercontent.com/esnet/iperf/master/docs/2017-04-27.txt
130
131
1322017-03-06:  iperf-3.1.7 released
133---------------------------------
134
135| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.7.tar.gz
136| SHA256:  ``a4ef73406fe92250602b8da2ae89ec53211f805df97a1d1d629db5a14043734f  iperf-3.1.7.tar.gz``
137
138This version of iperf3 contains two documentation fixes, but is
139otherwise identical to the prior release.
140
141
1422017-02-02:  iperf-3.1.6 released
143---------------------------------
144
145| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.6.tar.gz
146| SHA256:  ``70f0c72d9e60c6ecb2c478ed17e4fd81d3b827d57896fee43bcd0c53abccb29d  iperf-3.1.6.tar.gz``
147
148This version of iperf3 contains two minor fixes.  Notably, one of them
149unbreaks JSON output with UDP tests.
150
151
1522017-01-12:  iperf-3.1.5 released
153---------------------------------
154
155| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.5.tar.gz
156| SHA256:  ``6e1a6200cd38baeab58ef0d7b8769e7aa6410c3a3168e65ea8277a4de79e5500  iperf-3.1.5.tar.gz``
157
158This version of iperf3 makes some improvements to the fair-queue-based
159pacing and improves the selection of the default UDP packet size.
160Users who use either of these aspects of iperf3 are encourage to
161review the release notes for this version.
162
163
1642016-10-31:  iperf-3.1.4 released
165---------------------------------
166
167| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.4.tar.gz
168| SHA256:  ``db61d70ac62003ebe0bf15496bd8c4b3c4b728578a44d0a1a88fcf8afc0e8f76  iperf-3.1.4.tar.gz``
169
170This release fixes a few minor bugs, including a
171(non-security-impacting) buffer overflow fix ported from upstream
172cjson.
173
174
1752016-06-08:  Security Issue:  iperf-3.1.3, iperf-3.0.12 released
176----------------------------------------------------------------
177
178| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.3.tar.gz
179| SHA256:  ``60d8db69b1d74a64d78566c2317c373a85fef691b8d277737ee5d29f448595bf  iperf-3.1.3.tar.gz``
180
181| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.12.tar.gz
182| SHA256:  ``9393d646e4e616f0cd7864bc8ceacc379f5d36b08003a3d8d65cd7c99d15daec  iperf-3.0.12.tar.gz``
183
184These releases address a security issue that could cause a crash of an
185iperf3 process (it could theoretically lead to a remote code
186execution).  Although the risk for common use cases is believed to be
187low, all users are encouraged to update to these versions or newer as
188soon as possible.  More information on the security vulnerability can
189be found in the following ESnet Software Security Advisory:
190
191https://raw.githubusercontent.com/esnet/security/master/cve-2016-4303/esnet-secadv-2016-0001.txt.asc
192
193iperf-3.1.3 also includes support for fair-queueing, per-socket based
194pacing of tests on platforms that support it (currently recent Linux
195distributions), as well as several other fixes.
196
197
1982016-02-01:  iperf-3.1.2 released
199---------------------------------
200
201| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.2.tar.gz
202| SHA256:  ``f9dbdb99f869c077d14bc1de78675f5e4b8d1bf78dc92381e96c3eb5b1fd7d86  iperf-3.1.2.tar.gz``
203
204This release fixes a couple of minor bugs, including one that results
205in invalid JSON being emitted for UDP tests.
206
207Older News
208----------
209
2102015-11-19:  iperf-3.1.1 released
211.................................
212
213| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.1.tar.gz
214| SHA256:  ``62f7c64eafe19046ba974b3ef2d962a5597194d6fbbddde328a15a5e74110564  iperf-3.1.1.tar.gz``
215
216This release fixes a few minor bugs.
217
2182015-10-16:  iperf3 Development Status
219......................................
220
221Beginning with the release of iperf 3.1, ESnet plans to support iperf3
222in "maintenance mode".  At this point, we have no definite plans for
223further iperf3 releases, and ESnet will be providing a very limited
224amount of resources for support and development, going forward.
225However, ESnet could issue new iperf3 releases to deal with security
226issues or high-impact bug fixes.
227
228Requests for support, enhancements, and questions should best be
229directed to the iperf-dev mailing list.  ESnet would be open to adding
230project members/committers from the community, in case there are
231developers who are interested in doing more active work with iperf3
232and/or supporting the user base.
233
234
2352015-10-16:  iperf-3.1 released
236...............................
237
238| URL:  http://downloads.es.net/pub/iperf/iperf-3.1.tar.gz
239| SHA256:  ``4385a32ece25cb09d4606b4c99316356b3d2cb03b318aa056b99cdb91c5ce656  iperf-3.1.tar.gz``
240
241This release adds support for SCTP on supported platforms, better
242feature detection on FreeBSD, better compatibility with various
243platforms, and a number of bug fixes.
244
245
2462015-01-09:  iperf-3.0.11 released
247..................................
248
249| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.11.tar.gz
250| SHA256:  ``e01db5be6f47f67c987463095fe4f5b8b9ff891fb92c39104d042ad8fde97f6e  iperf-3.0.11.tar.gz``
251
252This maintenance release adds a -1 flag to make the iperf3 execute a
253single test and exit, needed for an upcoming bwctl release.  A few
254other bugs are also fixed.
255
2562014-12-16:  iperf-3.0.10 released
257..................................
258
259| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.10.tar.gz
260| SHA256:  ``a113442967cf0981b0b2d538be7c88903b2fb0f87b0d281384e41b462e33059d  iperf-3.0.10.tar.gz``
261
262This maintenance release fixes building on MacOS X Yosemite, as well
263as making the -w option work correctly with UDP tests.
264
2652014-10-14:  iperf-3.0.9 released
266.................................
267
268| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.9.tar.gz
269| SHA256:  ``40249a2b30d26b937350b969bcb19f88e1beb356f886ed31422b554bac692459  iperf-3.0.9.tar.gz``
270
271This maintenance release fixes an issue for a situation in which
272attempting a UDP test with pathologically large (and illegal) packet
273sizes could put the iperf3 server in a state where it would stop
274accepting connections from clients, thus causing the clients to crash
275when interrupted.
276
277
2782014-09-30:  iperf-3.0.8 released
279.................................
280
281| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.8.tar.gz
282| SHA256:  ``81b8d91159862896c57f9b90a006e8b5dc22bd94175d97bd0db50b0ae2c1a78e  iperf-3.0.8.tar.gz``
283
284This maintenance release is functionally identical to 3.0.7.  It
285incorporates updated license verbage and a minor compilation fix.
286
287
2882014-08-28:  iperf-3.0.7 released
289.................................
290
291| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.7.tar.gz
292| SHA256:  ``49510e886f9e876cd73dcd80414bfb8c49b147c82125585e09c2a6e92369d3f2  iperf-3.0.7.tar.gz``
293
294This maintenance release fixes several minor bugs.  Of particular
295note:
296
297* A bug that caused some problems with bwctl / perfSONAR has been
298  fixed.
299
300* A bug that made it possible to disrupt existing, running tests has
301  been fixed.
302
3032014-07-28:  iperf-3.0.6 released
304.................................
305
306| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.6.tar.gz
307| SHA256:  ``3c5909c9b286b6503ffa141a94cfc588915d6e67f2aa732b08df0af73e21938  iperf-3.0.6.tar.gz``
308
309This maintenance release includes the following bug fixes:
310
311* Several problems with the -B option have been fixed.  Also, API
312  calls have been added to libiperf to extend this functionality to
313  API clients.
314
315* Some portability fixes for OpenBSD and Solaris have been merged from
316  the mainline.
317
318As always, more details can be found in the ``RELEASE_NOTES`` file in
319the source distribution.
320
3212014-06-16:  Project documentation on GitHub Pages
322..................................................
323
324iperf3 project documentation can now be found at:
325
326| URL:  http://software.es.net/iperf/
327
328This is a GitHub Pages site.  In an ongoing series of steps, content
329will be migrated from the iperf3 wiki to GitHub Pages.
330
3312014-06-16:  iperf-3.0.5 released
332.................................
333
334| URL:  http://downloads.es.net/pub/iperf/iperf-3.0.5.tar.gz
335| SHA256:  ``e1e1989985b17a4c03b0fa207004ad164b137e37ab0682fecbf5e93bcaa920a6  iperf-3.0.5.tar.gz``
336
337This is the third maintenance release of iperf 3, with few more
338enhancements and bug fixes.  Highlights:
339
340* A timing issue which caused measurement intervals to be wrong with
341  TCP tests on lossy networks has been fixed.
342
343* It is now possible to get (most of) the server-side output at
344  the client by using the ``--get-server-output`` flag.
345
346* A number of bugs with ``--json`` output have been fixed.
347
348A more extensive list of changes can always be found in the
349``RELEASE_NOTES`` file in the source distribution.
350
351Note:  An iperf-3.0.4 release was planned and tagged, but not
352officially released.
353
3542014-06-10:  New iperf3 download site
355.....................................
356
357iperf3 downloads are now hosted on a new server at ESnet:
358
359| URL:  http://downloads.es.net/pub/iperf/
360
361Going forward, new releases will be made available in this directory.
362Older releases will, at least for now, continue to also be available
363at the previous location.
364
3652014-03-26:  iperf-3.0.3 released
366.................................
367
368| URL:  http://stats.es.net/software/iperf-3.0.3.tar.gz
369| SHA256:  ``79daf3e5e5c933b2fc4843d6d21c98d741fe39b33ac05bd7a11c50d321a2f59d  iperf-3.0.3.tar.gz``
370
371This is the second maintenance release of iperf 3.0, containing a few bug fixes and enhancements, notably:
372
373* The structure of the JSON output is more consistent between the
374  cases of one stream and multiple streams.
375
376* The example programs once again build correctly.
377
378* A possible buffer overflow related to error output has been fixed.
379  (This is not believed to be exploitable.)
380
381More information on changes can be found in the ``RELEASE_NOTES``
382file in the source distribution.
383
3842014-03-10:  iperf-3.0.2 released
385.................................
386
387| URL:  http://stats.es.net/software/iperf-3.0.2.tar.gz
388| SHA256:  ``3c379360bf40e6ac91dfc508cb43fefafb4739c651d9a8d905a30ec99095b282  iperf-3.0.2.tar.gz``
389
390**Note:**  Due to a mistake in the release process, the distribution tarball referred to above is actually not compressed, despite its ``.tar.gz`` extension.  Instead it is an uncompressed tar archive.  The file checksum is correct, as are the file contents.
391
392This version is a maintenance release that
393fixes a number of bugs, many reported by users, adds a few minor
394enhancements, and tracks the migration of the iperf3 project to
395GitHub.  Of particular interest:
396
397* Build / runtime fixes for CentOS 5, MacOS 10.9, and FreeBSD.
398
399* TCP snd_cwnd output on Linux in the default output format.
400
401* libiperf is now built as both a shared and static library; by
402  default, the iperf3 binary links to the shared library.
403
404More information on changes can be found in the ``RELEASE_NOTES``
405file in the source distribution.
406
4072014-02-28:  iperf migrated to GitHub
408.....................................
409
410The new project page can be found at:
411
412https://github.com/esnet/iperf
413
4142014-01-10:  iperf-3.0.1 released
415.................................
416
417| URL:  http://stats.es.net/software/iperf-3.0.1.tar.gz
418| SHA256:  ``32b419ef634dd7670328c3cecc158babf7d706bd4b3d248cf95965528a20e614 iperf-3.0.1.tar.gz``
419
420During development, there were various distributions of the source
421code unofficially released carrying a 3.0.0 version number.  Because
422of the possibility for confusion, this first public release of iperf3
423was numbered 3.0.1.
424