iperf

Myth丶恋晨 2022-08-13 09:30 224阅读 0赞

# localadmin@openstack:~$ iperf --help Usage: iperf \[-s|-c host\] \[options\]        iperf \[-h|--help\] \[-v|--version\] Client/Server:   -f, --format    \[kmKM\]   format to report: Kbits, Mbits, KBytes, MBytes   -i, --interval  \#        seconds between periodic bandwidth reports   -l, --len       \#\[KM\]    length of buffer to read or write (default 8 KB)   -m, --print\_mss          print TCP maximum segment size (MTU - TCP/IP header)   -o, --output    <filename> output the report or error message to this specified file   -p, --port      \#        server port to listen on/connect to   -u, --udp                use UDP rather than TCP   -w, --window    \#\[KM\]    TCP window size (socket buffer size)   -B, --bind      <host>   bind to <host>, an interface or multicast address   -C, --compatibility      for use with older versions does not sent extra msgs   -M, --mss       \#        set TCP maximum segment size (MTU - 40 bytes)   -N, --nodelay            set TCP no delay, disabling Nagle's Algorithm   -V, --IPv6Version        Set the domain to IPv6 Server specific:   -s, --server             run in server mode   -U, --single\_udp         run in single threaded UDP mode   -D, --daemon             run the server as a daemon Client specific:   -b, --bandwidth \#\[KM\]    for UDP, bandwidth to send at in bits/sec                            (default 1 Mbit/sec, implies -u)   -c, --client    <host>   run in client mode, connecting to <host>   -d, --dualtest           Do a bidirectional test simultaneously   -n, --num       \#\[KM\]    number of bytes to transmit (instead of -t)   -r, --tradeoff           Do a bidirectional test individually   -t, --time      \#        time in seconds to transmit for (default 10 secs)   -F, --fileinput <name>   input the data to be transmitted from a file   -I, --stdin              input the data to be transmitted from stdin   -L, --listenport \#       port to receive bidirectional tests back on   -P, --parallel  \#        number of parallel client threads to run   -T, --ttl       \#        time-to-live, for multicast (default 1)   -Z, --linux-congestion <algo>  set TCP congestion control algorithm (Linux only) Miscellaneous:   -x, --reportexclude \[CDMSV\]   exclude C(connection) D(data) M(multicast) S(settings) V(server) reports   -y, --reportstyle C      report as a Comma-Separated Values   -h, --help               print this message and quit   -v, --version            print version information and quit \[KM\] Indicates options that support a K or M suffix for kilo- or mega- The TCP window size option can be set by the environment variable TCP\_WINDOW\_SIZE. Most other options can be set by an environment variable IPERF\_<long option name>, such as IPERF\_BANDWIDTH. Report bugs to <iperf-users@lists.sourceforge.net> #

# 什么是Iperf？ #

Iperf  是一个网络性能测试工具。Iperf可以测试TCP和UDP带宽质量。Iperf可以测量最大TCP带宽，具有多种参数和UDP特性。Iperf可以报告带宽，延迟抖动和数据包丢失。

# 编译与安装 #

Iperf2.0.2目前仅提供源码包的下载。当你下载到Iperf源码包后，在类unix系统上，需要先解压缩源码包，使用解压缩命令gzip或tar。解压后会产生新文件夹“Iperf-2.0.2”。Iperf2.0.2在以下操作系统中可以很好的被编译：Linux， SGI IRIX， HP-UX， Solaris， AIX， 和Cray UNICOS。使用“make”命令编译Iperf源码。完整的编译命令如下：

gunzip -c iperf-2.0.2.tar.gz 或 tar zxvf iperf-2.0.2.tar.gz

cd iperf-2.0.2

./configure

make

编译成功后，使用以下命令安装Iperf：

make install

重新编译Iperf，最简单的方法是使用以下命令：

make distclean

./configure

make

如果遇到任何问题，请发邮件至dast@nlanr.net，我们将尽快修复错误。

# 功能介绍 #

l  TCP

n  测量网络带宽

n  报告MSS/MTU值的大小和观测值

n  支持TCP窗口值通过套接字缓冲

n  当P线程或Win32线程可用时，支持多线程。客户端与服务端支持同时多重连接

l  UDP

n  客户端可以创建指定带宽的UDP流

n  测量丢包

n  测量延迟

n  支持多播

n  当P线程可用时，支持多线程。客户端与服务端支持同时多重连接（不支持Windows）

l   在适当的地方，选项中可以使用K（kilo-）和M（mega-）。例如131072字节可以用128K代替。

l   可以指定运行的总时间，甚至可以设置传输的数据总量。

l   在报告中，为数据选用最合适的单位。

l   服务器支持多重连接，而不是等待一个单线程测试。

l   在指定时间间隔重复显示网络带宽，波动和丢包情况。

l   服务器端可作为后台程序运行。

l   服务器端可作为Windows 服务运行。

l   使用典型数据流来测试链接层压缩对于可用带宽的影响。

# 参数与说明 #

<table> 
 <tbody> 
 <tr> 
 <td> 命令行选项 </td> 
 <td> 环境变量选项 </td> 
 <td> 描述 </td> 
 </tr> 
 <tr> 
 <td colspan="3"> 客户端与服务器端选项 </td> 
 </tr> 
 <tr> 
 <td> -f, --format [bkmaBKMA] </td> 
 <td> $IPERF_FORMAT </td> 
 <td> 格式化带宽数输出。支持的格式有： &nbsp;&nbsp;&nbsp; 'b' = bits/sec&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'B' = Bytes/sec &nbsp;&nbsp;&nbsp; 'k' = Kbits/sec&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'K' = KBytes/sec &nbsp;&nbsp;&nbsp; 'm' = Mbits/sec&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'M' = MBytes/sec &nbsp;&nbsp;&nbsp; 'g' = Gbits/sec&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'G' = GBytes/sec &nbsp;&nbsp;&nbsp; 'a' = adaptive bits/sec&nbsp;&nbsp; 'A' = adaptive Bytes/sec 自适应格式是kilo-和mega-二者之一。除了带宽之外的字段都输出为字节，除非指定输出的格式，默认的参数是a。 注意：在计算字节byte时，Kilo = 1024， Mega = 1024^2，Giga = 1024^3。通常，在网络中，Kilo = 1000， Mega = 1000^2， and Giga = 1000^3，所以，Iperf也按此来计算比特（位）。如果这些困扰了你，那么请使用-f b参数，然后亲自计算一下。 </td> 
 </tr> 
 <tr> 
 <td> -i, --interval # </td> 
 <td> $IPERF_INTERVAL </td> 
 <td> 设置每次报告之间的时间间隔，单位为秒。如果设置为非零值，就会按照此时间间隔输出测试报告。默认值为零。 </td> 
 </tr> 
 <tr> 
 <td> -l, --len #[KM] </td> 
 <td> $IPERF_LEN </td> 
 <td> 设置读写缓冲区的长度。TCP方式默认为8KB，UDP方式默认为1470字节。 &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -m, --print_mss </td> 
 <td> $IPERF_PRINT_MSS </td> 
 <td> 输出TCP MSS值（通过TCP_MAXSEG支持）。MSS值一般比MTU值小40字节。通常情况 &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -p, --port # </td> 
 <td> $IPERF_PORT </td> 
 <td> 设置端口，与服务器端的监听端口一致。默认是5001端口，与ttcp的一样。 </td> 
 </tr> 
 <tr> 
 <td> -u, --udp </td> 
 <td> $IPERF_UDP </td> 
 <td> 使用UDP方式而不是TCP方式。参看-b选项。 </td> 
 </tr> 
 <tr> 
 <td> -w, --window #[KM] </td> 
 <td> $TCP_WINDOW_SIZE </td> 
 <td> 设置套接字缓冲区为指定大小。对于TCP方式，此设置为TCP窗口大小。对于UDP方式，此设置为接受UDP数据包的缓冲区大小，限制可以接受数据包的最大值。 </td> 
 </tr> 
 <tr> 
 <td> -B, --bind host </td> 
 <td> $IPERF_BIND </td> 
 <td> 绑定到主机的多个地址中的一个。对于客户端来说，这个参数设置了出栈接口。对于服务器端来说，这个参数设置入栈接口。这个参数只用于具有多网络接口的主机。在Iperf的UDP模式下，此参数用于绑定和加入一个多播组。使用范围在224.0.0.0至239.255.255.255的多播地址。参考-T参数。 </td> 
 </tr> 
 <tr> 
 <td> -C, --compatibility </td> 
 <td> $IPERF_COMPAT </td> 
 <td> 与低版本的Iperf使用时，可以使用兼容模式。不需要两端同时使用兼容模式，但是强烈推荐两端同时使用兼容模式。某些情况下，使用某些数据流可以引起1.7版本的服务器端崩溃或引起非预期的连接尝试。 </td> 
 </tr> 
 <tr> 
 <td> -M, --mss #[KM} </td> 
 <td> $IPERF_MSS </td> 
 <td> 通过TCP_MAXSEG选项尝试设置TCP最大信息段的值。MSS值的大小通常是TCP/IP头减去40字节。在以太网中，MSS值 为1460字节（MTU1500字节）。许多操作系统不支持此选项。 </td> 
 </tr> 
 <tr> 
 <td> -N, --nodelay </td> 
 <td> $IPERF_NODELAY </td> 
 <td> 设置TCP无延迟选项，禁用Nagle's运算法则。通常情况此选项对于交互程序，例如telnet，是禁用的。 </td> 
 </tr> 
 <tr> 
 <td> -V (from v1.6 or higher) </td> 
 <td> &nbsp; </td> 
 <td> 绑定一个IPv6地址。 服务端：$ iperf -s –V 客户端：$ iperf -c &lt;Server IPv6 Address&gt; -V 注意：在1.6.3或更高版本中，指定IPv6地址不需要使用-B参数绑定，在1.6之前的版本则需要。在大多数操作系统中，将响应IPv4客户端映射的IPv4地址。 </td> 
 </tr> 
 <tr> 
 <td colspan="3"> 服务器端专用选项 </td> 
 </tr> 
 <tr> 
 <td> -s, --server </td> 
 <td> $IPERF_SERVER </td> 
 <td> Iperf服务器模式 </td> 
 </tr> 
 <tr> 
 <td> -D (v1.2或更高版本) </td> 
 <td> &nbsp; </td> 
 <td> Unix平台下Iperf作为后台守护进程运行。在Win32平台下，Iperf将作为服务运行。 </td> 
 </tr> 
 <tr> 
 <td> -R(v1.2或更高版本，仅用于Windows) </td> 
 <td> &nbsp; </td> 
 <td> 卸载Iperf服务（如果它在运行）。 </td> 
 </tr> 
 <tr> 
 <td> -o(v1.2或更高版本，仅用于Windows) </td> 
 <td> &nbsp; </td> 
 <td> 重定向输出到指定文件 </td> 
 </tr> 
 <tr> 
 <td> -c, --client host </td> 
 <td> $IPERF_CLIENT </td> 
 <td> 如果Iperf运行在服务器模式，并且用-c参数指定一个主机，那么Iperf将只接受指定主机的连接。此参数不能工作于UDP模式。 </td> 
 </tr> 
 <tr> 
 <td> -P, --parallel # </td> 
 <td> $IPERF_PARALLEL </td> 
 <td> 服务器关闭之前保持的连接数。默认是0，这意味着永远接受连接。 </td> 
 </tr> 
 <tr> 
 <td colspan="3"> 客户端专用选项 </td> 
 </tr> 
 <tr> 
 <td> -b, --bandwidth #[KM] </td> 
 <td> $IPERF_BANDWIDTH </td> 
 <td> UDP模式使用的带宽，单位bits/sec。此选项与-u选项相关。默认值是1 Mbit/sec。 </td> 
 </tr> 
 <tr> 
 <td> -c, --client host </td> 
 <td> $IPERF_CLIENT </td> 
 <td> 运行Iperf的客户端模式，连接到指定的Iperf服务器端。 </td> 
 </tr> 
 <tr> 
 <td> -d, --dualtest </td> 
 <td> $IPERF_DUALTEST </td> 
 <td> 运行双测试模式。这将使服务器端反向连接到客户端，使用-L 参数中指定的端口（或默认使用客户端连接到服务器端的端口）。这些在操作的同时就立即完成了。如果你想要一个交互的测试，请尝试-r参数。 </td> 
 </tr> 
 <tr> 
 <td> -n, --num #[KM] </td> 
 <td> $IPERF_NUM </td> 
 <td> 传送的缓冲器数量。通常情况，Iperf按照10秒钟发送数据。-n参数跨越此限制，按照指定次数发送指定长度的数据，而不论该操作耗费多少时间。参考-l与-t选项。 </td> 
 </tr> 
 <tr> 
 <td> -r, --tradeoff </td> 
 <td> $IPERF_TRADEOFF </td> 
 <td> 往复测试模式。当客户端到服务器端的测试结束时，服务器端通过-l选项指定的端口（或默认为客户端连接到服务器端的端口），反向连接至客户端。当客户端连接终止时，反向连接随即开始。如果需要同时进行双向测试，请尝试-d参数。 </td> 
 </tr> 
 <tr> 
 <td> -t, --time # </td> 
 <td> $IPERF_TIME </td> 
 <td> 设置传输的总时间。Iperf在指定的时间内，重复的发送指定长度的数据包。默认是10秒钟。参考-l与-n选项。 </td> 
 </tr> 
 <tr> 
 <td> -L, --listenport # </td> 
 <td> $IPERF_LISTENPORT </td> 
 <td> 指定服务端反向连接到客户端时使用的端口。默认使用客户端连接至服务端的端口。 </td> 
 </tr> 
 <tr> 
 <td> -P, --parallel # </td> 
 <td> $IPERF_PARALLEL </td> 
 <td> 线程数。指定客户端与服务端之间使用的线程数。默认是1线程。需要客户端与服务器端同时使用此参数。 </td> 
 </tr> 
 <tr> 
 <td> -S, --tos # </td> 
 <td> $IPERF_TOS </td> 
 <td> 出栈数据包的服务类型。许多路由器忽略TOS字段。你可以指定这个值，使用以“0x”开始的16进制数，或以“0”开始的8进制数或10进制数。 例如，16进制'0x10' = 8进制'020' = 十进制'16'。TOS值1349就是： <pre>&nbsp;&nbsp;&nbsp; IPTOS_LOWDELAY&nbsp;&nbsp;&nbsp;&nbsp; minimize delay&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0x10</pre> <pre>&nbsp;&nbsp;&nbsp; IPTOS_THROUGHPUT&nbsp;&nbsp; maximize throughput&nbsp;&nbsp; 0x08</pre> <pre>&nbsp;&nbsp;&nbsp; IPTOS_RELIABILITY&nbsp; maximize reliability&nbsp; 0x04</pre> <pre>&nbsp;&nbsp;&nbsp; IPTOS_LOWCOST&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; minimize cost&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0x02</pre> </td> 
 </tr> 
 <tr> 
 <td> -T, --ttl # </td> 
 <td> $IPERF_TTL </td> 
 <td> 出栈多播数据包的TTL值。这本质上就是数据通过路由器的跳数。默认是1，链接本地。 </td> 
 </tr> 
 <tr> 
 <td> -F (from v1.2 or higher) </td> 
 <td> &nbsp; </td> 
 <td> 使用特定的数据流测量带宽，例如指定的文件。 $ iperf -c &lt;server address&gt; -F &lt;file-name&gt; </td> 
 </tr> 
 <tr> 
 <td> -I (from v1.2 or higher) </td> 
 <td> &nbsp; </td> 
 <td> 与-F一样，由标准输入输出文件输入数据。 </td> 
 </tr> 
 <tr> 
 <td colspan="3"> 杂项 </td> 
 </tr> 
 <tr> 
 <td> -h, --help </td> 
 <td> &nbsp; </td> 
 <td> 显示命令行参考并退出 。 </td> 
 </tr> 
 <tr> 
 <td> -v, --version </td> 
 <td> &nbsp; </td> 
 <td> 显示版本信息和编译信息并退出。 </td> 
 </tr> 
 </tbody> 
</table>

##### 举例： #####

1）TCP测试

服务器执行：./iperf -s -i 1 -w 1M  
客户端执行：./iperf -c host -i 1 -w 1M

其中-w表示TCP window size，host需替换成服务器地址。

2）UDP测试  
服务器执行：./iperf -u -s  
客户端执行：./iperf -u -c 10.255.255.251 -b 900M  -i 1  -w 1M  -t 60  
其中-b表示使用多少带宽，1G的线路你可以使用900M进行测试。