fragattacks/wpadebug/README
Jouni Malinen 4bb4f7cd00 wpadebug: Add a Wi-Fi debugging app for Android
This tool can be used to debug Wi-Fi functionality on Android both
through the Android framework and through direct access to
wpa_supplicant.

Signed-hostap: Jouni Malinen <j@w1.fi>
2013-05-03 02:09:53 +03:00

57 lines
1.5 KiB
Plaintext

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 chmod 6755 /system/bin/mksh-su
Uninstallation
--------------
adb root
adb remount
adb shell rm /system/bin/mksh-su
adb uninstall w1.fi.wpadebug