| wpadebug - wpa_supplicant and Wi-Fi debugging app for Android | |
| Copyright (c) 2013, Jouni Malinen <j@w1.fi> and contributors | |
| All Rights Reserved. | |
| This program is licensed under the BSD license (the one with | |
| advertisement clause removed). See the top level README for detailed | |
| license text. | |
| If you are submitting changes to the project, please see CONTRIBUTIONS | |
| file for more instructions. | |
| NOTE! This Android app is for debugging and testing purposes only. It is | |
| not supposed to be installed on a production use device and doing so may | |
| result in complete loss of security protections on the device. | |
| Build | |
| ----- | |
| - Install Android SDK and build tools | |
| - update project target if desired; for example: | |
| android list targets | |
| android update project --target 1 --path $PWD | |
| - run: ant debug | |
| Installation (with adb over USB) | |
| ------------ | |
| adb install bin/wpadebug-debug.apk | |
| NOTE: Following steps enable any app on the system to get root access! | |
| This is not suitable for any production use. This is needed for direct | |
| wpa_supplicant access and some networking operating in general. You can | |
| still use rest of the wpadebug app without doing this, but those | |
| functions will not work unless this step part of installation is | |
| done. It should be obvious that these steps require a rooted device. In | |
| addition, if you do not understand what the following commands do, | |
| please do not run them. | |
| adb root | |
| adb remount | |
| adb shell cp /system/bin/mksh /system/bin/mksh-su | |
| adb shell chmod 6755 /system/bin/mksh-su | |
| Optionally, a text file with a set of command can be installed to allow | |
| arbitrary shell commands to be executed. This text file need to be in | |
| /data/local/wpadebug.cmds and use title@command format per line. For | |
| example: | |
| version@cat /proc/version | |
| Similarly, /data/local/wpadebug.wpacmds can be used to define additional | |
| wpa_supplicant control interface commands. | |
| Uninstallation | |
| -------------- | |
| adb root | |
| adb remount | |
| adb shell rm /system/bin/mksh-su | |
| adb uninstall w1.fi.wpadebug |