porting iperf to Android platform

http://blog.chinaunix.net/u3/103613/showart_2037838.html

下面的文档描述如何移植 iperf 到 android 平台中

1. download iperf source code
latest iperf version from the below link: http://sourceforge.net/projects/iperf/ and then unzip it.
tar zxvf iperf_2.0.4.orig.tar.gz

2. copy iperf-2.0.4
copy iperf-2.0.4 folder to external/ in cupcake or other Android version, and rename it as iperf.

3. add header files
add two header files in iperf folder
iperf/include/iperf-int.h
iperf/config.h
you can get it if you build iperf source code in iperf formal package.

4. add Makefile
add a new Android.mk in iperf folder for Android environment.
and the context is as belows:

#
# Copyright (C) 2008 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0 #
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
LOCAL_PATH := $(call my-dir)

OBJS += compat/error.c
OBJS += compat/snprintf.c
OBJS += compat/inet_ntop.c
OBJS += compat/inet_pton.c
OBJS += compat/signal.c
OBJS += compat/Thread.c
OBJS += compat/string.c
OBJS += compat/gettimeofday.c
OBJS += src/gnu_getopt.c
OBJS += src/gnu_getopt_long.c
OBJS += src/tcp_window_size.c
OBJS += src/service.c
OBJS += src/sockets.c
OBJS += src/stdio.c
OBJS += src/ReportCSV.c
OBJS += src/Locale.c
OBJS += src/ReportDefault.c
OBJS += src/Reporter.c
OBJS += src/Extractor.c
OBJS += src/SocketAddr.c
OBJS += compat/delay.cpp
OBJS += src/Server.cpp
OBJS += src/Client.cpp
OBJS += src/List.cpp
OBJS += src/Launch.cpp
OBJS += src/PerfSocket.cpp
OBJS += src/Settings.cpp
OBJS += src/Listener.cpp
OBJS += src/main.cpp

INCLUDES = $(LOCAL_PATH)/include

L_CFLAGS = -DH***E_CONFIG_H

########################


include $(CLEAR_VARS)
LOCAL_MODULE := iperf
#LOCAL_SHARED_LIBRARIES := libc libcutils libutils libnetutils libstdc++
LOCAL_CFLAGS := $(L_CFLAGS)
LOCAL_SRC_FILES := $(OBJS)
LOCAL_C_INCLUDES := $(INCLUDES)
include $(BUILD_EXECUTABLE)
########################

4. do modification
do some modification which blocks the build.
4.1 util.h
because Android environment has also one util.h, and Make system will select it instead of util.h in iperf folder,
so we need let Make system select local util.h. one easy method is to use below sentence.
#include "include/util.h"
instead of
#include "util.h"

4.2 headers.h
for iperf/include/headers.h
#ifndef NDEBUG
#define NDEBUG
#endif
instead of
#define NDEBUG

4.3 Listener.cpp
for iperf/src/Listener.cpp
delete the below since we don't care about ipv6 currently.
mreq.ipv6mr_interface = 0;

实例

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进行测试。

功能介绍

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 使用典型数据流来测试链接层压缩对于可用带宽的影响。