+3
Daily
8,886
stars
1,472
forks
221
watchers
691
prs
1,202
issues
13
releases
README
!iperf3 logo iperf3: A TCP, UDP, and SCTP network bandwidth measurement tool ================================================================ Summary ------- iperf is a tool for active measurement 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 measured throughput / bitrate, 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. One of the primary uses for iperf3 is as a component of the perfSONAR network measurement system (https://www.perfsonar.net/). It is also useful as a standalone tool, and is used as such by ESnet and other R&E networks. It has also been found useful in the general networking community and has even found its way into various commercial products. Primary development for iperf3 takes place on Ubuntu Linux, FreeBSD, and macOS. 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. For more information see: https://software.es.net/iperf Source code and issue tracker: https://github.com/esnet/iperf Discussion forums: https://github.com/esnet/iperf/discussions Reporting security vulnerabilities: [email protected] Frequently Asked Questions: https://software.es.net/iperf/faq.html Obtaining iperf3 ---------------- Downloads of iperf3 are available at: https://downloads.es.net/pub/iperf/ To check out the most recent code, clone the git repository at: https://github.com/esnet/iperf.git Building iperf3 --------------- Prerequisites: None. Building ./configure; make; make install (Note: If configure fails, try running ./bootstrap.sh first) Invoking iperf3 --------------- 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: https://fasterdata.es.net/performance-testing/network-troubleshooting-tools/iperf/ 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 flag
Top issues
#1233iperf3: error - unable to send control message: Bad file descriptor31 comments · 2021-11-21#1314--bidir option randomly fails with "iperf3: error - unable to connect stream: No such file or directory" on Windows27 comments · 2022-04-08#1069Incorrect and impossible upload result using TCP27 comments · 2020-11-08#1986Server hangs endlessly (0.00 Mbits/sec) on sudden client disconnect – Works in 3.14, broken in 3.16+18 comments · 2025-12-17#1808iperf3: error - unable to receive parameters from client: Bad file descriptor13 comments · 2024-12-12#1374Bug - Mixed speed broadband only measures the Maximum upload not the download15 comments · 2022-08-16#1882`iperf3: error - unable to receive cookie at server: Bad file descriptor`14 comments · 2025-05-14#1735The iperf3 server hangs while printing the report14 comments · 2024-07-18
Discussions
#2098An iPerf3 client front-end with a focus on portability0 comments · 2026-10-29#2082iperf-3.220 comments · 2026-09-29#2078anyone know site contact for https://iperf.fr2 comments · 2026-09-16#2074How to Set Up an End-to-End 100 Gbps Bandwidth/Throughput Test?1 comments · 2026-09-05#2070iperf3 UDP sender limited to ~10 Mbps over Ethernet but ~95 Mbps over Wi-Fi4 comments · 2026-08-19#2068Windows 11 dotnet Frontend for iPerf3?1 comments · 2026-08-15#2065High CPU utilization on RX side with UDP GRO (--gsro)12 comments · 2026-08-07#2056Interoperability issue? lost_packets is 0 on client side if different versions are used1 comments · 2026-07-06
Latest release
iperf-3.22 3.22 2026-09-29iperf-3.22 2026-09-29
---------------------
Security notes
Thanks to Claude and Ada Logics for finding and reporting two
potential security vulnerabilities. One is a remote
use-after-free in iperf_server_api.c (ANT-2026-E5BA80X9 /
CVE-2026-101283) and the other is a heap buffer overflow in
iperf_auth.c (ANT-2026-FXH14FHV / CVE-2026-101276).
Thanks to Justin Stitt for reporting and fixing a heap-buffer
overflow was fixed in iperf_auth.c (PR 2027).
Thanks to Ravindu Lakmina Munaweera (Github: @Ravi-lk) for
reporting and fixin