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 割り当ての追跡とリークチェック。
  • worst-case inspector コールバックを用いた Profiling。

ビルド手順

ビルドは 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 はフィクスチャファイル内の TESTENTRY マクロに由来します (例: TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...))。

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

バイナリ

自身のプロジェクトに静的リンクするための devkit は、Frida の releases ページからダウンロードできます。