GhostLock-App

中文: README_ZH.md

Unterstützte Geräte

Kernel werden anhand der exakten uname -r-Ausgabe abgeglichen; nicht unterstützte Builds werden abgelehnt und die App zeigt den Status oben an. Die Offsets befinden sich in src/kernels/<uname-release>/offsets.h — neue Builds lassen sich mit --register des Extractors hinzufügen.

Schnellstart

Öffne GhostLock und tippe auf Run. KernelSU (me.weishu.kernelsu) oder ReSukiSU (com.resukisu.resukisu) stellt ksud für das Laden von Modulen bereit; ohne diese wird über W1/W2 zwar uid 0 gewährt, aber kein Modul geladen.

Die Route lässt zwei Kerne gegeneinander antreten: Der Hauptthread belegt pselect intensiv, während ein Consumer-Thread die Priorität des Wartenden stört. Das Paar verwendet standardmäßig die großen Kerne (Fallback 0/1), überschreibbar über GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Kommandozeilen-Debugging

adb/shell hat keinen seccomp-Filter, daher wird W3 übersprungen — praktisch für eine schnelle Überprüfung:

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

Offset-Extraktion

tools/extract_rs leitet Offsets aus einer boot.img (plus optionaler xbl_config.img), einem vollständigen OTA-ZIP oder einer http(s)-URL, die auf eines davon verweist, ab. kallsyms stammen aus --kallsyms oder werden aus der eingebetteten Tabelle des Images wiederhergestellt. pselect_waiter_shift und off_slide_loggers_0_1 werden vom integrierten arm64-Disassembler abgeleitet. MediaTek-Images haben keine xbl_config.img und meist kein BTF: Die physische Ladeadresse wird aus dem kallsyms-_text abgeleitet (überschreibbar mit --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 speichert die Tabelle unter src/kernels/<uname-release>/offsets.h; --format c --out offsets.h erzeugt einen eigenständigen Header.

Analyse auf dem Gerät

Ein vollständiges OTA kann vollständig auf dem Telefon analysiert werden: boot und xbl_config werden automatisch extrahiert. Übergib --work-dir ein beschreibbares Verzeichnis, wenn innerhalb der App-Sandbox ausgeführt wird. Cross-kompilieren und übertragen:

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

Offsets importieren ohne die App neu zu bauen

Neue Kernel benötigen keinen App-Neubau mehr: Tippe auf Import offsets.json und wähle das JSON des Extractors (einzelnes Objekt oder Array), oder schiebe es nach <GHOSTLOCK_HOME>/offsets.json (Standard /data/local/tmp). Beim Start gleicht der native Code die aktuelle uname -r mit den importierten Einträgen ab, bevor der Kernel abgelehnt wird. Importe werden über Dateien hinweg zusammengeführt; ein bereits gespeicherter Release fragt vor dem Überschreiben nach.

Die App kann das JSON auch selbst erzeugen — Parse OTA link (vollständige OTA-ZIP- URL) und Parse image (boot.img + optionale xbl_config.img) führen den Extractor prozessintern aus und schreiben bei Erfolg offsets.json in das App-Datenverzeichnis.

[
  {
    "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 & Lizenz

Basiert auf den folgenden Projekten, lizenziert unter Apache License 2.0 (siehe LICENSE):

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