eadb - eBPF Android Debug Bridge
eadb provides a powerful Linux shell environment where one can run BCC / bpftrace / bpftool on Android device.
Usage
Install the eadb first, please refer Install
Prepare eadb environment on Android device
eadb support two mode to connect the device:
- adb
- ssh
Both of them need the root privilege.
If you want to use adb
mode, adb root
is required but adb root
is disabled in production build, if you doesn't have any userdebug / eng devices, you can try adb_root. But it you don't any experience on Magisk(it may brick your device), it is recommended to use ssh
mode.
If you use ssh
mode, it is recommended to install Magisk to Root your device and install MagiskSSH to enable ssh.
Download it from github
When you can use adb or ssh to connect to your device, you can prepare the eadb environment:
eadb --ssh root@ip prepare
The command would download a rootfs from Release page and push it to your device, then do some mounts and chroot in to the environment.
Use an existing archive
You can also download or build the rootfs and then prepare it by your rootfs file:
eadb --ssh root@ip prepare -a path/to/archive
Enter the environment
eadb --ssh root@ip shell
You will enter the eadb environment and get a shell by this command, you can use apt update
to update the sources and install softwares(such as clang,llvm,bpftrace) by yourself, you can even install Rust
/ Golang
or gcc
to do development on this device!
Build the environment by yourself
Only Ubuntu / Debian is supported to build the system image running on Android, you can use docker or podman on macOS and WSL on Windows.
Install qemu-user-static
and debootstrap
first:
sudo apt update && sudo apt install qemu-user-static debootstrap
And then build the eadb (root is required):
sudo eadb build
After the build, you will get a debianfs-full(mini).tar.gz
in your working directory. you can use this image as your environment:
eadb --ssh root@ip prepare -a deb.tar.gz
Install
Binary
Download binaries in Release page
Build from source
- Install Rust toolchain
- git clone https://github.com/tiann/eadb
- cargo build
Cargo
If you have Rust toolchain installed, you can install it with cargo:
cargo install eadb
Credits
All my credits to adeb! eadb is just a rewritten for adeb.
Contact
twsxtd#gmail.com