1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
.TH IPERF 1 "APRIL 2008" NLANR/DAST "User Manuals"
.SH NAME
iperf \- perform network throughput tests
.SH SYNOPSIS
.B iperf \-s [
.I options
.B ]
.B iperf \-c
.I server
.B [
.I options
.B ]
.B iperf \-u \-s [
.I options
.B ]
.B iperf \-u \-c
.I server
.B [
.I options
.B ]
.SH DESCRIPTION
iperf is a tool for performing network throughput measurements. It can test
either TCP or UDP throughput. To perform an iperf test the user must
establish both a server (to discard traffic) and a client (to generate
traffic).
.SH "GENERAL OPTIONS"
.TP
.BR \-e ", " \-\-enhanced " "
Display enhanced output in reports
.TP
.BR \-f ", " \-\-format " "
[kmKM] format to report: Kbits, Mbits, KBytes, MBytes
.TP
.BR \-h ", " \-\-help " "
print a help synopsis
.TP
.BR \-i ", " \-\-interval " \fIn\fR"
pause \fIn\fR seconds between periodic bandwidth reports
.TP
.BR \-l ", " \-\-len " \fIn\fR[KM]"
set length read/write buffer to \fIn\fR (default 8 KB)
.TP
.BR \-m ", " \-\-print_mss " "
print TCP maximum segment size (MTU - TCP/IP header)
.TP
.BR \-o ", " \-\-output " \fIfilename\fR"
output the report or error message to this specified file
.TP
.BR \-p ", " \-\-port " \fIn\fR"
set server port to listen on/connect to to \fIn\fR (default 5001)
.TP
.BR \-u ", " \-\-udp " "
use UDP rather than TCP
.TP
.BR \-w ", " \-\-window " \fIn\fR[KM]"
TCP window size (socket buffer size)
.TP
.BR \-z ", " \-\-realtime " "
Request realtime scheduler, if supported.
.TP
.BR \-B ", " \-\-bind " \fIhost\fR"
bind to \fIhost\fR, an interface or multicast address
.TP
.BR \-C ", " \-\-compatibility " "
for use with older versions does not sent extra msgs
.TP
.BR \-M ", " \-\-mss " \fIn\fR"
set TCP maximum segment size (MTU - 40 bytes)
.TP
.BR \-N ", " \-\-nodelay " "
set TCP no delay, disabling Nagle's Algorithm
.TP
.BR \-v ", " \-\-version " "
print version information and quit
.TP
.BR \-V ", " \-\-IPv6Version " "
Set the domain to IPv6
.TP
.BR \-x ", " \-\-reportexclude " [CDMSV]"
exclude C(connection) D(data) M(multicast) S(settings) V(server) reports
.TP
.BR \-y ", " \-\-reportstyle " C|c"
if set to C or c report results as CSV (comma separated values)
.SH "SERVER SPECIFIC OPTIONS"
.TP
.BR \-s ", " \-\-server " "
run in server mode
.TP
.BR \-U ", " \-\-single_udp " "
run in single threaded UDP mode
.TP
.BR \-D ", " \-\-daemon " "
run the server as a daemon. On Windows this will also install the IPerfService.
.TP
.BR \-R ", " \-\-remove " "
remove the IPerfService (Windows only).
.SH "CLIENT SPECIFIC OPTIONS"
.TP
.BR \-b ", " \-\-bandwidth " \fIn\fR[KMG] | \fIn\fRpps"
set target bandwidth to \fIn\fR bits/sec (default 1 Mbit/sec) or
\fIn\fR packets per sec. This may be used with TCP or UDP.
.TP
.BR \-c ", " \-\-client " \fIhost\fR"
run in client mode, connecting to \fIhost\fR
.TP
.BR \-d ", " \-\-dualtest " "
Do a bidirectional test simultaneously
.TP
.BR \-n ", " \-\-num " \fIn\fR[KM]"
number of bytes to transmit (instead of \-t)
.TP
.BR \-r ", " \-\-tradeoff " "
Do a bidirectional test individually
.TP
.BR \-t ", " \-\-time " \fIn\fR"
time in seconds to transmit for (default 10 secs)
.TP
.BR \-B ", " \-\-bind " \fIip\fR | \fIip\fR:\fIport\fR"
bind src addr(s) from which to originate traffic
.TP
.BR \-F ", " \-\-fileinput " \fIname\fR"
input the data to be transmitted from a file
.TP
.BR \-I ", " \-\-stdin " "
input the data to be transmitted from stdin
.TP
.BR \-L ", " \-\-listenport " \fIn\fR"
port to receive bidirectional tests back on
.TP
.BR \-P ", " \-\-parallel " \fIn\fR"
number of parallel client threads to run
.TP
.BR \-T ", " \-\-ttl " \fIn\fR"
time-to-live, for multicast (default 1)
.TP
.BR \-Z ", " \-\-linux-congestion " \fIalgo\fR"
set TCP congestion control algorithm (Linux only)
.SH ENVIRONMENT
.TP
.BR TCP_WINDOW_SIZE
Controls the size of TCP buffers.
.SH DIAGNOSTICS
This section needs to be filled in.
.SH BUGS
Exit statuses are inconsistent.
The threading implementation is rather heinous.
.SH AUTHORS
Iperf was originally written by Mark Gates and Alex Warshavsky.
Man page and maintence by Jon Dugan <jdugan at x1024 dot net>.
Other contributions from Ajay Tirumala, Jim Ferguson,
Feng Qin,
Kevin Gibbs,
John Estabrook <jestabro at ncsa.uiuc.edu>,
Andrew Gallatin <gallatin at gmail.com>,
Stephen Hemminger <shemminger at linux\-foundation.org>
.SH "SEE ALSO"
http://iperf.sourceforge.net/
|
