Gum

Кроссплатформенная библиотека инструментирования и интроспекции, написанная на C.

Эта библиотека используется в frida-core через её привязки к JavaScript, GumJS.

Предоставляет:

• Ядро инструментирования

  • Встраиваемые хуки: Interceptor
  • Скрытное трассирование кода: Stalker
  • Мониторинг памяти: MemoryAccessMonitor

• Кроссплатформенная интроспекция

  • Запущенные потоки и другое состояние process
  • Загруженные модули, включая их:
    • Импорты
    • Экспорты
    • Символы
  • Сканирование Memory
  • Поиск DebugSymbol
  • Реализации Backtracer
  • Состояние Kernel (пока только iOS)

• Внепроцессный динамический линковщик для i/macOS: Gum.Darwin.Mapper

• Генерация кода:

  • X86Writer
  • ArmWriter
  • ThumbWriter
  • Arm64Writer
  • MipsWriter

• Перемещение кода:

  • X86Relocator
  • ArmRelocator
  • ThumbRelocator
  • Arm64Relocator
  • MipsRelocator

• Вспомогательные библиотеки для разработчиков, которым нужна высокая детализация:

  • Отслеживание выделения памяти в Heap и проверка утечек.
  • Profiling с обратным вызовом worst-case inspector.

Инструкции по сборке

Сборки можно настраивать с помощью скрипта configure. Для пользователей Windows доступен configure.bat.

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

Запустите configure с --help, чтобы увидеть все опции.

Тестирование

Тесты собираются с помощью make test и запускаются с помощью ./build/tests/gum-tests. Вы можете указать путь к тесту с помощью -p, чтобы запустить конкретный тест или группу тестов.

Пути тестов следуют шаблону /<Area>/<Module>/<test_name>, где область/модуль берутся из макросов TESTENTRY в файлах фикстур (например, TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)).

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

Бинарные файлы

Скачайте devkit для статической линковки в ваши собственные проекты со страницы releases Frida.