strongSwan

h1. strongSwan on Android

The IKEv2 daemon charon has been ported to "Google Android":http://www.android.com.

This document describes how to build strongSwan for Android 2.0 (using the emulator).

h2. Android Source Tree

You will need the complete Android source to build strongSwan. Instructions on how to download and build it can be found on the "Android website":http://source.android.com/download.

To checkout a specific branch or tag of the sources, specify it with the @-b@ parameter when using the @repo init@ command.

Since building the whole source tree takes quite a while you should probably start with this first:

<pre>

cd /path/to/android/source

. build/envsetup.sh

lunch 1

make

</pre>

h2. Android Kernel

The prebuilt kernel that is used for the emulator lacks some modules required for strongSwan to work correctly. It is therefore required to build a custom kernel. To get the current kernel config you can use the adb tool to download it from the running emulator. After starting the emulator use

<pre>

adb pull /proc/config.gz config.gz

</pre>to copy the config to the current directory. Then enable the missing modules, this is mainly @CONFIG_XFRM_USER@ and @CONFIG_NET_KEY@ but might include other modules.

Please compare your config to the list of [[KernelModules|required modules]] in this wiki (please note that some modules, especially all the IPv6 related modules, are not really required).

Clone the kernel sources and checkout an appropriate tag (check the version of the kernel in the emulator). For example:

<pre>

git clone git://android.git.kernel.org/kernel/common kernel

cd kernel

git checkout -t origin/android-goldfish-2.6.29

</pre>

You can then copy your config to this directory and compile the kernel sources using

<pre>

export ARCH=arm

export CROSS_COMPILE=/path/to/android/source/prebuilt/linux-x86/toolchain/arm-eabi-4.4.0/bin/arm-eabi-

make oldconfig

make

</pre>

To start the emulator using your custom kernel use the following command:

<pre>

emulator -kernel /path/to/kernel/source/arch/arm/boot/zImage &

</pre>