GhostLock-App

中文: README_ZH.md

Dispositivi Supportati

I kernel vengono abbinati tramite l'esatto uname -r; le build non supportate vengono rifiutate e l'app mostra lo stato in alto. Gli offset risiedono in src/kernels/<uname-release>/offsets.h — aggiungi nuove build con --register dell'estrattore.

Avvio Rapido

Apri GhostLock e tocca Run. KernelSU (me.weishu.kernelsu) o ReSukiSU (com.resukisu.resukisu) fornisce ksud per il caricamento dei moduli; senza di esso, W1/W2 concedono comunque uid 0 ma nessun modulo viene caricato.

La route mette in competizione due core: il thread principale martella pselect mentre un thread consumer perturba la priorità del waiter. La coppia predefinita usa i big core (fallback 0/1), sovrascrivibile tramite GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Debug da Riga di Comando

adb/shell non ha filtro seccomp, quindi W3 viene saltato — utile per una verifica rapida:

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

Estrazione Offset

tools/extract_rs deriva gli offset da un boot.img (più un xbl_config.img opzionale), da uno ZIP OTA completo, o da un URL http(s) che punta a uno di essi. I kallsyms provengono da --kallsyms o vengono recuperati dalla tabella incorporata nell'immagine. pselect_waiter_shift e off_slide_loggers_0_1 sono derivati dal disassemblatore arm64 integrato. Le immagini MediaTek non hanno xbl_config.img e di solito nessun BTF: l'indirizzo di caricamento fisico è derivato dal kallsyms _text (sovrascrivibile con --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 salva la tabella sotto src/kernels/<uname-release>/offsets.h; --format c --out offsets.h genera un header autonomo.

Analisi sul dispositivo

Un OTA completo può essere analizzato interamente sul telefono: boot e xbl_config vengono estratti automaticamente. Passa --work-dir a una directory scrivibile dall'app quando esegui all'interno della sandbox dell'app. Cross-compila e invia:

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

Importare gli offset senza ricompilare l'app

I nuovi kernel non richiedono più una ricompilazione dell'app: tocca Import offsets.json e seleziona il JSON dell'estrattore (singolo oggetto o array), oppure invialo a <GHOSTLOCK_HOME>/offsets.json (predefinito /data/local/tmp). All'avvio il codice nativo abbina l'attuale uname -r alle voci importate prima di rifiutare il kernel. Gli import vengono uniti tra file; una release già memorizzata richiede conferma prima della sovrascrittura.

L'app può anche generare il JSON da sola — Parse OTA link (URL ZIP OTA completo) e Parse image (boot.img + xbl_config.img opzionale) eseguono l'estrattore in-process e scrivono offsets.json nella directory dati dell'app in caso di successo.

[
  {
    "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 }
  }
]

Crediti e Licenza

Basato sui seguenti progetti, concesso in licenza sotto Apache License 2.0 (vedi LICENSE):

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