GhostLock-App

中文: README_ZH.md

Supported Devices

Kernel	Devices
6.1.118-android14-11-gca0ef6d17716-ab13624819	Xiaomi 14
6.1.138-android14-11-g0c3d559bcd85-ab14529422	Xiaomi 14
6.1.145-android14-11-g09f1c0074ad7-ab14226177	Infinix Note 50s 5G
6.6.30-android15-8-g54dcbfbef792-ab12368803-4k	Red Magic Tablet 3 Pro
6.6.77-android15-8-g4a507830d890-ab13636293-4k	Xiaomi Civi 5 Pro, REDMI K90 / 4 Turbo, POCO F7
6.6.77-android15-8-g63ce7556864c-ab13994517-4k	Xiaomi 15
6.6.77-android15-8-gca30f3b4bef6-abogki440974771-4k	Xiaomi 15 Pro, REDMI K80 Pro / K80 Ultra
6.6.89-android15-8-g096cdb6ecefc-ab14358676-4k	OPPO Pad 4 Pro
6.6.89-android15-8-g0889fe95bb10-ab14402178-4k	POCO X8 Pro Max
6.6.89-android15-8-gf4dc45704e54-abogki446052083-4k	OnePlus 13
6.6.92-android15-8-g3637f4904cf5-ab13944661-4k	Red Magic Tablet 3 Pro, Red Magic 10 Pro, Red Magic 11 Air
6.6.102-android15-8-gab8eb70a71b8-ab14350911-4k	Nothing Phone 3
6.6.102-android15-8-gb01b41c2647c-ab15574720-4k	Xiaomi 17T
6.6.102-android15-8-gfe76d1bc97fd-ab14689815-4k	Xiaomi 17T
6.6.118-android15-8-g2e6b9c3812c5-ab15114928-4k	OPPO Find N5
6.6.118-android15-8-g93e223c276e7-abogki500782043-4k	OPPO Find X8 Ultra, OnePlus 13 / ACE 5 Pro
6.6.118-android15-8-g608a629fedf7-ab15154340-4k	REDMI K90 Ultra
6.6.118-android15-8-gc44b714366cc-abogki519650608-4k	REDMI K80 Pro / Turbo 5 Max, POCO X8 Pro Max, Xiaomi Pad 7 Ultra
6.6.118-android15-8-ge56cf6b09cca-ab15511674-4k	REDMI K90 Ultra, POCO F7
6.6.118-android15-8-ge58033dc8ea6-abogki498046332-4k	OPPO Pad 5, OnePlus Pad 2
6.6.118-android15-8-gebdfad32d749-ab15099304-4k	OPPO Find X8 / Find X8 Pro
6.12.23-android16-5-g16e473de48a3-abogki462654244-4k	REDMI K90 Pro Max
6.12.23-android16-5-g75e9b1c7ae7c-abogki463945075-4k	Xiaomi 17 / 17 Pro / 17 Pro Max / 17 Ultra
6.12.23-android16-5-g82efd98459a2-ab14457512-4k	OPPO Find X9 / Find X9 Pro
6.12.23-android16-5-ga8f88ad96df3-ab13929693-4k	OnePlus 15
6.12.23-android16-5-gb2a876903b49-ab14541642-4k	OnePlus 15
6.12.23-android16-5-gf1bdb13583da-ab13761046-4k	Red Magic 11 Pro, Tablet 5 Pro
6.12.30-android16-5-g6e872b4863d6-ab13847919-4k	REDMI Note 15 4G, POCO M6 Pro 4G
6.12.38-android16-5-g844001fb8721-ab14552068-4k	OnePlus 15T

Kernels are matched by exact uname -r; unsupported builds are rejected and the app shows the status at the top. Offsets live in src/kernels/<uname-release>/offsets.h — add new builds with the extractor's --register.

Quick Start

Open GhostLock and tap Run. KernelSU (me.weishu.kernelsu) or ReSukiSU (com.resukisu.resukisu) provides ksud for module loading; without it, W1/W2 still grant uid 0 but no module is loaded.

The route races two cores: the main thread hammers pselect while a consumer thread perturbs the waiter's priority. The pair defaults to the big cores (fallback 0/1), overridable via GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Command-Line Debugging

adb/shell has no seccomp filter, so W3 is skipped - handy for quick verification:

make ghostlock
adb push ghostlock /data/local/tmp/ghostlock
adb shell chmod 755 /data/local/tmp/ghostlock
adb shell /data/local/tmp/ghostlock

Offset Extraction

tools/extract_rs derives offsets from a boot.img (plus optional xbl_config.img), a full OTA ZIP, or an http(s) URL pointing at one. kallsyms come from --kallsyms or are recovered from the image's embedded table. pselect_waiter_shift and off_slide_loggers_0_1 are derived by the built-in arm64 disassembler. MediaTek images have no xbl_config.img and usually no BTF: the physical load address is derived from kallsyms _text (override with --phys).

cargo build --release --manifest-path tools/extract_rs/Cargo.toml
tools/extract_rs/target/release/ghostlock-extract.exe boot.img --xbl-config xbl_config.img --register
tools/extract_rs/target/release/ghostlock-extract.exe OTA.zip --format json --out offsets.json

--register saves the table under src/kernels/<uname-release>/offsets.h; --format c --out offsets.h dumps a standalone header.

On-device analysis

A full OTA can be analyzed entirely on the phone: boot plus xbl_config are extracted automatically. Pass --work-dir an app-writable dir when running inside the app sandbox. Cross-compile and push:

rustup target add aarch64-linux-android
$ndk = "$env:ANDROID_HOME\ndk\29.0.14206865\toolchains\llvm\prebuilt\windows-x86_64\bin"
$env:CC_aarch64_linux_android = "$ndk\aarch64-linux-android35-clang.cmd"
$env:AR_aarch64_linux_android = "$ndk\llvm-ar.exe"
$env:CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER = $env:CC_aarch64_linux_android
cargo build --release --target aarch64-linux-android --manifest-path tools/extract_rs/Cargo.toml
adb push tools/extract_rs/target/aarch64-linux-android/release/ghostlock-extract /data/local/tmp/
adb shell /data/local/tmp/ghostlock-extract /sdcard/OTA.zip

Importing offsets without rebuilding the app

New kernels no longer need an app rebuild: tap Import offsets.json and pick the extractor's JSON (single object or array), or push it to <GHOSTLOCK_HOME>/offsets.json (default /data/local/tmp). At startup native matches the current uname -r against imported entries before rejecting the kernel. Imports merge across files; a release already stored prompts before overwrite.

The app can also generate the JSON itself — Parse OTA link (full OTA ZIP URL) and Parse image (boot.img + optional xbl_config.img) run the extractor in-process and write offsets.json into the app data dir on success.

[{
  "release": "6.12.38-android16-5-g844001fb8721-ab14552068-4k",
  "kernel_phys_load": 3347054592,
  "pselect_waiter_shift": 0,
  "symbols": { "off_init_task": 37801728, "off_init_cred": 37891184 },
  "struct_fields": { "task_prio": 148, "task_cred": 2304 }
}]

Credits & License

Based on the following projects, licensed under Apache License 2.0 (see LICENSE):

• NebuSec/CyberMeowfia
• JoinChang/ghostlock-oneplus
• x-spy/CVE-2026-43499-popsicle