Gum

Libreria di strumentazione e introspezione cross-platform scritta in C.

Questa libreria è utilizzata da frida-core attraverso i suoi binding JavaScript, GumJS.

Fornisce:

• Core di strumentazione

  • Inline hooking: Interceptor
  • Tracciamento del codice stealth: Stalker
  • Monitoraggio della memoria: MemoryAccessMonitor

• Introspezione cross-platform

  • Thread in esecuzione e altro stato del processo
  • Moduli caricati, incluse le loro:
    • Importazioni
    • Esportazioni
    • Simboli
  • Scansione della memoria
  • Ricerche di DebugSymbol
  • Implementazioni di Backtracer
  • Stato del Kernel (solo iOS per ora)

• Linker dinamico out-of-process per i/macOS: Gum.Darwin.Mapper

• Generazione di codice:

  • X86Writer
  • ArmWriter
  • ThumbWriter
  • Arm64Writer
  • MipsWriter

• Rilocazione del codice:

  • X86Relocator
  • ArmRelocator
  • ThumbRelocator
  • Arm64Relocator
  • MipsRelocator

• Librerie di supporto per sviluppatori che necessitano di funzionalità altamente granulari:

  • Tracciamento dell'allocazione dell'Heap e controllo delle perdite di memoria.
  • Profiling con callback worst-case inspector.

Istruzioni di compilazione

Le build possono essere configurate con lo script configure. configure.bat è disponibile per gli utenti Windows.

./configure --enable-gumpp --enable-gumjs --enable-tests
make

Esegui configure con --help per vedere tutte le opzioni.

Test

I test vengono compilati con make test ed eseguiti con ./build/tests/gum-tests. Puoi specificare un percorso di test con -p per eseguire un test specifico o un gruppo di test.

I percorsi dei test seguono il pattern /<Area>/<Module>/<test_name> dove area/module provengono dalle macro TESTENTRY nei file fixture (ad es. TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)).

./build/tests/gum-tests
./build/tests/gum-tests -p /Core/Interceptor/attach_one

Binari

Scarica un devkit per il linking statico nei tuoi progetti dalla pagina delle releases di Frida.