Gum

用 C 编写的跨平台插桩与内省库。

该库通过其 JavaScript 绑定 GumJS 被 frida-core 使用。

提供：

• 插桩核心

  • 内联钩子：Interceptor
  • 隐蔽代码跟踪：Stalker
  • 内存监控：MemoryAccessMonitor

• 跨平台内省

  • 运行中的线程及其他[进程][]状态
  • 已加载模块，包括其：
    • 导入
    • 导出
    • 符号
  • [内存][]扫描
  • DebugSymbol 查找
  • Backtracer 实现
  • Kernel 状态（目前仅限 iOS）

• 用于 i/macOS 的进程外动态链接器：Gum.Darwin.Mapper

• 代码生成：

  • X86Writer
  • ArmWriter
  • ThumbWriter
  • Arm64Writer
  • MipsWriter

• 代码重定位：

  • X86Relocator
  • ArmRelocator
  • ThumbRelocator
  • Arm64Relocator
  • MipsRelocator

• 面向需要高度细粒度功能的开发者的辅助库：

  • Heap 分配跟踪与泄漏检查。
  • 带[最坏情况检查器][]回调的[性能分析][]。

构建说明

构建可通过 configure 脚本进行配置。Windows 用户可使用 configure.bat。

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

使用 --help 运行 configure 以查看所有选项。

测试

测试通过 make test 构建，并通过 ./build/tests/gum-tests 运行。 你可以使用 -p 指定测试路径，以运行特定测试或测试组。

测试路径遵循 /<Area>/<Module>/<test_name> 模式，其中 area/module 来自 fixture 文件中的 TESTENTRY 宏（例如 TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)）。

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

二进制文件

从 Frida releases 页面下载用于静态链接到你自己的项目中的 devkit。