Gum

Biblioteca de instrumentação e introspecção multiplataforma escrita em C.

Esta biblioteca é consumida pelo frida-core através de suas vinculações JavaScript, GumJS.

Fornece:

• Núcleo de instrumentação

  • Hooking inline: Interceptor
  • Rastreamento de código furtivo: Stalker
  • Monitoramento de memória: MemoryAccessMonitor

• Introspecção multiplataforma

  • Threads em execução e outros estados de processo
  • Módulos carregados, incluindo seus:
    • Imports
    • Exports
    • Símbolos
  • Escaneamento de memória
  • Consultas de DebugSymbol
  • Implementações de Backtracer
  • Estado do Kernel (apenas iOS por enquanto)

• Linker dinâmico fora do processo para i/macOS: Gum.Darwin.Mapper

• Geração de código:

  • X86Writer
  • ArmWriter
  • ThumbWriter
  • Arm64Writer
  • MipsWriter

• Relocação de código:

  • X86Relocator
  • ArmRelocator
  • ThumbRelocator
  • Arm64Relocator
  • MipsRelocator

• Bibliotecas auxiliares para desenvolvedores que precisam de informações altamente granulares:

  • Rastreamento de alocação de Heap e verificação de vazamentos.
  • Profiling com callback de inspetor de pior caso.

Instruções de Compilação

As compilações podem ser configuradas com o script configure. configure.bat está disponível para usuários Windows.

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

Execute o configure com --help para ver todas as opções.

Testes

Os testes são compilados com make test e executados com ./build/tests/gum-tests. Você pode especificar um caminho de teste com -p para executar um teste específico ou grupo de testes.

Os caminhos de teste seguem o padrão /<Area>/<Module>/<test_name> onde a área/módulo vêm das macros TESTENTRY nos arquivos de fixture (por exemplo, TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)).

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

Binários

Baixe um devkit para vinculação estática em seus próprios projetos na página de releases do Frida.