projects / thirdparty / hostap.git / blame
| Commit | Line | Data |
|---|---|---|
| 4bb4f7cd JM |
1 | wpadebug - wpa_supplicant and Wi-Fi debugging app for Android |
| 2 | Copyright (c) 2013, Jouni Malinen <j@w1.fi> and contributors | |
| 3 | All Rights Reserved. | |
| 4 | ||
| 5 | This program is licensed under the BSD license (the one with | |
| 6 | advertisement clause removed). See the top level README for detailed | |
| 7 | license text. | |
| 8 | ||
| 9 | If you are submitting changes to the project, please see CONTRIBUTIONS | |
| 10 | file for more instructions. | |
| 11 | ||
| 12 | ||
| 13 | NOTE! This Android app is for debugging and testing purposes only. It is | |
| 14 | not supposed to be installed on a production use device and doing so may | |
| 15 | result in complete loss of security protections on the device. | |
| 16 | ||
| 17 | ||
| 18 | ||
| 19 | Build | |
| 20 | ----- | |
| 21 | ||
| 22 | - Install Android SDK and build tools | |
| 717f236d PK |
23 | |
| 24 | wpadebug depends on zxing core to launch QR code display/scanning. | |
| 25 | To 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 | ||
| 34 | To build wpadebug application: | |
| 35 | ||
| 4bb4f7cd JM |
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 | ||
| 42 | Installation (with adb over USB) | |
| 43 | ------------ | |
| 44 | ||
| 45 | adb install bin/wpadebug-debug.apk | |
| 46 | ||
| 47 | NOTE: Following steps enable any app on the system to get root access! | |
| 48 | This is not suitable for any production use. This is needed for direct | |
| 49 | wpa_supplicant access and some networking operating in general. You can | |
| 50 | still use rest of the wpadebug app without doing this, but those | |
| 51 | functions will not work unless this step part of installation is | |
| 52 | done. It should be obvious that these steps require a rooted device. In | |
| 53 | addition, if you do not understand what the following commands do, | |
| 54 | please do not run them. | |
| 55 | ||
| 56 | adb root | |
| 57 | adb remount | |
| 4ee18c92 | 58 | adb shell cp /system/bin/mksh /system/bin/mksh-su |
| 4bb4f7cd JM |
59 | adb shell chmod 6755 /system/bin/mksh-su |
| 60 | ||
| cb54718c JM |
61 | Optionally, a text file with a set of command can be installed to allow |
| 62 | arbitrary 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 | |
| 64 | example: | |
| 65 | version@cat /proc/version | |
| 4bb4f7cd | 66 | |
| a9008e43 JM |
67 | Similarly, /data/local/wpadebug.wpacmds can be used to define additional |
| 68 | wpa_supplicant control interface commands. | |
| 69 | ||
| 4bb4f7cd JM |
70 | |
| 71 | Uninstallation | |
| 72 | -------------- | |
| 73 | ||
| 74 | adb root | |
| 75 | adb remount | |
| 76 | adb shell rm /system/bin/mksh-su | |
| 77 | ||
| 78 | adb uninstall w1.fi.wpadebug |