New upstream release.
[debian/iodine.git] / README-android.txt
1 \r
2 \r
3 iodine - http://code.kryo.se/iodine\r
4 \r
5 ***********************************\r
6 \r
7 Extra README file for Android\r
8 \r
9 \r
10 == Running iodine on Android:\r
11 1. Get root access on your android device\r
12 \r
13 2. Find/build a compatible tun.ko for your specific Android kernel\r
14 \r
15 3. Copy tun.ko and the iodine binary to your device:\r
16    (Almost all devices need the armeabi binary. Only Intel powered \r
17    ones need the x86 build.)\r
18 \r
19                 adb push tun.ko /data/local/tmp\r
20                 adb push iodine /data/local/tmp\r
21                 adb shell\r
22                 su\r
23                 cd /data/local/tmp\r
24                 chmod 777 iodine\r
25 \r
26 4. Run iodine (see the man page for parameters)\r
27 \r
28                 ./iodine ...\r
29 \r
30 For more information: http://blog.bokhorst.biz/5123\r
31 \r
32 == Building iodine for Android:\r
33 1. Download and install the Android SDK and NDK\r
34 \r
35 2. Download and unpack the iodine sources\r
36 \r
37 3. Build:\r
38                 cd src\r
39                 make base64u.h base64u.c\r
40                 ndk-build NDK_PROJECT_PATH=. APP_BUILD_SCRIPT=Android.mk\r
41 \r
42    or run "make cross-android" in the iodine root directory.\r
43    To build for other archs, specify TARGET_ARCH_ABI: \r
44                 "make cross-android TARGET_ARCH_ABI=x86"\r
45 \r