• Stars
    star
    444
  • Rank 98,300 (Top 2 %)
  • Language
    Rust
  • License
    Apache License 2.0
  • Created over 2 years ago
  • Updated 8 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

eBPF Android Debug Bridge

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

  1. Install Rust toolchain
  2. git clone https://github.com/tiann/eadb
  3. 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

More Repositories

1

KernelSU

A Kernel based root solution for Android
Kotlin
10,005
star
2

epic

Dynamic java method AOP hook for Android(continution of Dexposed on ART), Supporting 5.0~11
Java
4,390
star
3

FreeReflection

A library that lets you use reflection without any restriction above Android P
C++
2,914
star
4

understand-plugin-framework

demos to help understand plugin framwork
Java
2,634
star
5

Leoric

PoC of fighting against force-stop kill process on Android
Java
1,811
star
6

markdown-img-upload

markdown图片实用工具
Python
417
star
7

super-adb

Enhance the adb shell using busybox, supporting vi、grep and awk etc. No need root.
Python
291
star
8

DirtyPipeRoot

Using DirtyPipe to gain temporary root access for Android devices.
Java
239
star
9

adb_root

Shell
155
star
10

android-native-debug

Debug Android Framework Native Code Tutorial.
C++
148
star
11

AnyLauncher

Any Launcher is OK for MIUI!
Java
50
star
12

VirtualAndroid

An Android emulator for Android device
32
star
13

graph-easy-cn

Perl 模块 Graph::Easy 中文文档
HTML
26
star
14

everything-in-python

The python implement of [everything](https://www.voidtools.com/)
25
star
15

ebpf-jnitrace

Trace jni calls with eBPF on Android
24
star
16

art-dex-interpret

Load dex on ART in interpret mode
Java
17
star
17

tiann.github.io

my personal blog
HTML
17
star
18

tiann

15
star
19

genshin_launch

原神启动 for KernelSU!
HTML
12
star
20

docker-build-android-kernel

Build Android kernel with Docker.
9
star
21

PtyProcess

PtyProcess for Android
C++
7
star
22

KernelSU_website

7
star
23

repo-mirror

Python
4
star
24

cmi-r-oss

C
4
star
25

hehe

3
star
26

onedrive

HTML
3
star
27

haskell-learning

my way to haskell
Haskell
2
star
28

arts

2
star
29

SyncService

1
star
30

ideas

inspiration
1
star
31

cross-paste

cross platform copy&paste tool
Python
1
star
32

py-luchchy-go

Py-launchy-Go is a Launchy python plugin that activates open windows from Launchy. It’s a python remake of an old Launchy plugin called Go-Y.
Python
1
star