GhostLock-App

中文: README_ZH.md

Dispositivos Suportados

Os kernels são correspondidos pelo uname -r exato; builds não suportados são rejeitados e o app mostra o status no topo. Os offsets ficam em src/kernels/<uname-release>/offsets.h — adicione novos builds com o --register do extrator.

Início Rápido

Abra o GhostLock e toque em Run. O KernelSU (me.weishu.kernelsu) ou ReSukiSU (com.resukisu.resukisu) fornece o ksud para carregamento de módulos; sem ele, W1/W2 ainda concedem uid 0, mas nenhum módulo é carregado.

A rota disputa dois núcleos: a thread principal martela pselect enquanto uma thread consumidora perturba a prioridade do waiter. O par usa por padrão os núcleos grandes (fallback 0/1), substituível via GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Depuração por Linha de Comando

O adb/shell não tem filtro seccomp, então W3 é ignorado — útil para verificação rápida:

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

Extração de Offsets

tools/extract_rs deriva offsets de um boot.img (mais xbl_config.img opcional), de um ZIP OTA completo, ou de uma URL http(s) apontando para um deles. Os kallsyms vêm de --kallsyms ou são recuperados da tabela embutida na imagem. pselect_waiter_shift e off_slide_loggers_0_1 são derivados pelo desmontador arm64 integrado. Imagens MediaTek não têm xbl_config.img e geralmente não têm BTF: o endereço físico de carga é derivado do kallsyms _text (substituível com --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 a tabela em src/kernels/<uname-release>/offsets.h; --format c --out offsets.h gera um cabeçalho autônomo.

Análise no dispositivo

Um OTA completo pode ser analisado inteiramente no telefone: boot e xbl_config são extraídos automaticamente. Passe --work-dir para um diretório gravável pelo app ao executar dentro do sandbox do app. Compile cruzado e envie:

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

Importando offsets sem recompilar o app

Novos kernels não precisam mais de recompilação do app: toque em Import offsets.json e escolha o JSON do extrator (objeto único ou array), ou envie-o para <GHOSTLOCK_HOME>/offsets.json (padrão /data/local/tmp). Na inicialização, o nativo compara o uname -r atual com as entradas importadas antes de rejeitar o kernel. As importações são mescladas entre arquivos; uma release já armazenada pede confirmação antes de sobrescrever.

O app também pode gerar o JSON por conta própria — Parse OTA link (URL do ZIP OTA completo) e Parse image (boot.img + xbl_config.img opcional) executam o extrator no processo e gravam offsets.json no diretório de dados do app em caso de sucesso.

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

Créditos e Licença

Baseado nos seguintes projetos, licenciados sob Apache License 2.0 (veja LICENSE):

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