- C 85.4%
- C++ 10.1%
- Python 1.8%
- Vala 1%
- Meson 0.8%
- Other 0.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .github | ||
| bindings | ||
| ext | ||
| gum | ||
| libs | ||
| releng@47d771e6f1 | ||
| subprojects | ||
| tests | ||
| tools | ||
| vapi | ||
| .cirrus.yml | ||
| .gitignore | ||
| .gitmodules | ||
| BSDmakefile | ||
| CLAUDE.md | ||
| configure | ||
| configure.bat | ||
| COPYING | ||
| make.bat | ||
| Makefile | ||
| meson.build | ||
| meson.options | ||
| README.md | ||
Gum
Cross-platform instrumentation and introspection library written in C.
This library is consumed by frida-core through its JavaScript bindings, GumJS.
Provides:
-
Instrumentation core
- Inline hooking: Interceptor
- Stealthy code tracing: Stalker
- Memory monitoring: MemoryAccessMonitor
-
Cross-platform introspection
- Running threads and other process state
- Loaded modules, including their:
- Imports
- Exports
- Symbols
- Memory scanning
- DebugSymbol lookups
- Backtracer implementations
- Kernel state (iOS only for now)
-
Out-of-process dynamic linker for i/macOS: Gum.Darwin.Mapper
-
Code generation:
-
Code relocation:
-
Helper libraries for developers needing highly granular:
- Heap allocation tracking and leak checking.
- Profiling with worst-case inspector callback.
Build Instructions
Builds can be configured with the configure script. configure.bat is
available for Windows users.
./configure --enable-gumpp --enable-gumjs --enable-tests
make
Run configure with --help to see all options.
Testing
Tests are built with make test and run with ./build/tests/gum-tests.
You can specify a test path with -p to run a specific test or group of
tests.
Test paths follow the pattern /<Area>/<Module>/<test_name> where the
area/module come from TESTENTRY macros in the fixture files (e.g.
TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)).
./build/tests/gum-tests
./build/tests/gum-tests -p /Core/Interceptor/attach_one
Binaries
Download a devkit for statically linking into your own projects from the Frida releases page.