README
1wpadebug - wpa_supplicant and Wi-Fi debugging app for Android
2Copyright (c) 2013, Jouni Malinen <j@w1.fi> and contributors
3All Rights Reserved.
4
5This program is licensed under the BSD license (the one with
6advertisement clause removed). See the top level README for detailed
7license text.
8
9If you are submitting changes to the project, please see CONTRIBUTIONS
10file for more instructions.
11
12
13NOTE! This Android app is for debugging and testing purposes only. It is
14not supposed to be installed on a production use device and doing so may
15result in complete loss of security protections on the device.
16
17
18
19Build
20-----
21
22- Install Android SDK and build tools
23
24wpadebug depends on zxing core to launch QR code display/scanning.
25To build zxing core:
26
27- mkdir hostap/wpadebug/libs # target for the jar file
28- Install maven tool
29- clone latest zxing code [git clone https://github.com/zxing/zxing.git]
30- cd zxing/core
31- run: mvn install -DskipTests
32- copy target/core-*.*.*-SNAPSHOT.jar to hostap/wpadebug/libs
33
34To build wpadebug application:
35
36- update project target if desired; for example:
37 android list targets
38 android update project --target 1 --path $PWD
39- run: ant debug
40
41
42Installation (with adb over USB)
43------------
44
45adb install bin/wpadebug-debug.apk
46
47NOTE: Following steps enable any app on the system to get root access!
48This is not suitable for any production use. This is needed for direct
49wpa_supplicant access and some networking operating in general. You can
50still use rest of the wpadebug app without doing this, but those
51functions will not work unless this step part of installation is
52done. It should be obvious that these steps require a rooted device. In
53addition, if you do not understand what the following commands do,
54please do not run them.
55
56adb root
57adb remount
58adb shell cp /system/bin/mksh /system/bin/mksh-su
59adb shell chmod 6755 /system/bin/mksh-su
60
61Optionally, a text file with a set of command can be installed to allow
62arbitrary shell commands to be executed. This text file need to be in
63/data/local/wpadebug.cmds and use title@command format per line. For
64example:
65version@cat /proc/version
66
67Similarly, /data/local/wpadebug.wpacmds can be used to define additional
68wpa_supplicant control interface commands.
69
70
71Uninstallation
72--------------
73
74adb root
75adb remount
76adb shell rm /system/bin/mksh-su
77
78adb uninstall w1.fi.wpadebug
79
