Measure bidirectional TCP throughput against an iperf3 server
Build a paste-ready command, then review its compatibility and effects before running it.
iperf3 -c <host> -p <port> --bidir --time <seconds> --format mComplete required fields to copy the generated command.
Compatibility
Linux + macOS + WindowsVerified for Linux, macOS, Windows using bash, zsh, powershell syntax.
Operational knowledgereview due 2027-01-19
Requirementsiperf3iperf3 must be installed and available on PATH.Network accessThe target must be reachable from the current environment.
Version supportiperf3 Current supported releasesVerified for linux, macos, windows using bash, zsh, powershell syntax; consult compatibility notes for platform-specific differences.
Expected signals[SUM][TX-C] 0.00-10.00 sec 1.09 GBytes 936 Mbits/sec senderRepresentative successful output; values vary with the selected target and system state.
Known errorsiperf3: command not foundiperf3 is missing or is not available on PATH.
Verifyiperf3 -c {{host}} -p {{port}} --bidir --time {{seconds}} --format mThe output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01iperf3CommandRuns the iperf3 stage of this one-liner.
02-cOptionConfigures iperf3 with the -c option.
03<host>ParameterA value supplied in the Fill parameters section.
04-pOptionSelects the command-specific port, process, or print mode.
05<port>ParameterA value supplied in the Fill parameters section.
06--bidirOptionConfigures iperf3 with the --bidir option.
07--timeOptionConfigures iperf3 with the --time option.
08<seconds>ParameterA value supplied in the Fill parameters section.
09--formatOptionFormats each result using the supplied template.
10mArgumentPasses m to iperf3.
This advanced community-curated one-liner combines several stages. Review every option and placeholder before running it.
Example input
iperf3 -c 10.24.1.20 -p 5201 --bidir --time 10 --format m
Example output
[SUM][TX-C] 0.00-10.00 sec 1.09 GBytes 936 Mbits/sec sender
[SUM][RX-C] 0.00-10.00 sec 1.07 GBytes 918 Mbits/sec receiver
Illustrative output — exact values vary by system and data.
Official sources