porting iperf to Android platform

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

1. download iperf source code
latest iperf version from the below link:

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.

文件:	iperf-two-headers.tar.gz
大小:	2KB
下载:	下载

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
#
#     
#
# 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 = -DHAVE_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;