How do I set up an iperf3 server and client for basic bandwidth testing?

Run 'iperf3 -s' on the server to start listening, then on the client use 'iperf3 -c ' to initiate a test. Adjust flags like -t for duration or -P for parallel streams as needed, with details in the manual page.

iperf3 vs iperf2: which should I use for network troubleshooting?

iperf3 offers a cleaner codebase, JSON output, and library features but isn't backwards compatible. iperf2 might be better if you need legacy tool integration or broader community scripts, as both are actively developed separately.

Does iperf3 support Windows operating systems?

iperf3 is not officially supported on Windows; primary development targets Linux, FreeBSD, and macOS. Community ports may exist, but they lack guaranteed stability or updates from the core team.

How can I use iperf3 JSON output in a Python script?

Use the --json flag during testing to output results in JSON format, then parse the data with Python's json module for automated analysis, such as extracting throughput or loss metrics programmatically.

What are the best iperf3 flags for testing high-speed networks?

Enable zero-copy mode with -Z for reduced CPU overhead, use -A for CPU affinity to bind processes, and adjust buffer sizes with -w to match network conditions, as recommended in the README for extreme optimizations.

Can iperf3 be used for continuous network monitoring?

iperf3 is designed for discrete tests, not real-time monitoring. For ongoing assessment, integrate it into cron jobs or scripts with the library API, but it lacks built-in monitoring features like alerting or dashboards.

Open-Awesome

iperf

NOASSERTIONC3.21

A tool for measuring maximum achievable network bandwidth using TCP, UDP, and SCTP protocols.

Visit Website GitHub

8.4k stars1.4k forks0 contributors

What is iperf?

iperf3 is a network bandwidth measurement tool that actively tests the maximum achievable throughput on IP networks using TCP, UDP, and SCTP protocols. It helps network administrators and engineers diagnose performance issues by measuring throughput, loss, and other parameters with tunable settings. The tool is widely used in research and education networks and has been integrated into various commercial products.

Target Audience

Network administrators, network engineers, researchers, and developers who need to measure and troubleshoot network performance in lab, data center, or production environments.

Value Proposition

Developers choose iperf3 for its modern implementation, smaller codebase, library functionality, and features like zero-copy mode and JSON output that were missing from the original iperf, while maintaining focus on typical application performance rather than artificial optimizations.

Overview

iperf3: A TCP, UDP, and SCTP network bandwidth measurement tool

Use Cases

Best For

Measuring maximum achievable bandwidth between network endpoints
Troubleshooting network performance issues in data centers
Testing network infrastructure under different protocol conditions (TCP/UDP/SCTP)
Integrating network performance testing into automated systems via its library API
Benchmarking network hardware and configuration changes
Validating network performance for research and education networks

Not Ideal For

Environments requiring backwards compatibility with iperf2 tools and scripts
Teams that prefer graphical user interfaces over command-line tools
Projects needing guaranteed official support on non-Linux/Unix platforms like Windows

Pros & Cons

Pros

Modern Protocol Coverage

Supports TCP, UDP, and SCTP protocols for comprehensive network testing, as highlighted in the key features, allowing varied performance assessments.

Performance Optimization Flags

Includes zero-copy mode using sendfile() and CPU affinity binding, enabling extreme best-case testing when explicitly activated, as noted in the README's philosophy.

Programmatic Integration Ready

Offers JSON output for scriptable results and a library version for embedding into other applications, enhancing automation and custom tooling.

Focused Default Behavior

Designed to show typical well-designed application performance by default, avoiding artificial optimizations, making it realistic for real-world scenarios.

Cons

No Backwards Compatibility

Explicitly not compatible with the original iperf, which can disrupt existing workflows and require toolchain updates, as admitted in the README.

Limited Platform Support

Officially supports only Ubuntu Linux, FreeBSD, and macOS, with other platforms like Windows or Android being experimental, potentially causing portability issues.

Command-Line Complexity

Requires familiarity with numerous flags and parameters for tuning, which can be overwhelming for casual users without extensive documentation or GUI aids.

Frequently Asked Questions

Related Projects

termshark

A terminal UI for tshark, inspired by Wireshark

Stars9,873

Forks434

Last commit2 years ago

openwifi

open-source IEEE 802.11 WiFi baseband FPGA (chip) design: driver, software

Stars4,602

Forks778

Last commit11 days ago

nethogs

Linux 'net top' tool

Stars3,616

Forks295

Last commit2 months ago

pyshark

Python wrapper for tshark, allowing python packet parsing using wireshark dissectors

Stars2,483

Forks445

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub