== Introduction == The goal of this tool is to enable adb as root on existing boot.img and recovery.img images. Having adb as root on boot.img and recovery.img can be very useful: usually root it not enabled by default in an unauthenticated way to protect against juice jacking, however there are cases where it's really required: - You might need to get early boot logs, and if your device isn't booting you cannot boot it to setup adb. - You might need to type commands as root in a recovery to recover non-booting devices. For instance if a corrupted partition can prevent booting. == Dependencies == - gunzip from gzip or other implementations - gzip from gzip or other implementations - mkbootimg from android-tools (http://tools.android.com/) - mktemp from coreutils or other implementations - python (version 3) - python-sh - sed from sed or other implementations - sha512sum from coreutils or other implementations - fso-unbootimg from freesmartphone.org utilities (git://github.com/freesmartphone/utilities.git)