Gum

Bibliothèque multiplateforme d'instrumentation et d'introspection écrite en C.

Cette bibliothèque est consommée par frida-core via ses bindings JavaScript, GumJS.

Fournit :

• Cœur d'instrumentation

  • Hook inline : Interceptor
  • Traçage de code furtif : Stalker
  • Surveillance mémoire : MemoryAccessMonitor

• Introspection multiplateforme

  • Threads en cours d'exécution et autres états de process
  • Modules chargés, y compris leurs :
    • Imports
    • Exports
    • Symboles
  • Scan de Memory
  • Recherches de DebugSymbol
  • Implémentations de Backtracer
  • État du Kernel (iOS uniquement pour l'instant)

• Linker dynamique hors processus pour i/macOS : Gum.Darwin.Mapper

• Génération de code :

  • X86Writer
  • ArmWriter
  • ThumbWriter
  • Arm64Writer
  • MipsWriter

• Relocation de code :

  • X86Relocator
  • ArmRelocator
  • ThumbRelocator
  • Arm64Relocator
  • MipsRelocator

• Bibliothèques d'assistance pour les développeurs ayant besoin d'un niveau très granulaire :

  • Suivi d'allocation Heap et détection de fuites.
  • Profiling avec callback worst-case inspector.

Instructions de compilation

Les compilations peuvent être configurées avec le script configure. configure.bat est disponible pour les utilisateurs Windows.

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

Exécutez configure avec --help pour voir toutes les options.

Tests

Les tests sont compilés avec make test et exécutés avec ./build/tests/gum-tests. Vous pouvez spécifier un chemin de test avec -p pour exécuter un test ou un groupe de tests spécifique.

Les chemins de test suivent le modèle /<Area>/<Module>/<test_name> où l'area/module provient des macros TESTENTRY dans les fichiers de fixture (par ex. TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)).

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

Binaires

Téléchargez un devkit pour lier statiquement dans vos propres projets depuis la page releases de Frida.