Gum

C로 작성된 크로스 플랫폼 계측 및 내부 검사 라이브러리.

이 라이브러리는 JavaScript 바인딩인 GumJS를 통해 frida-core에서 사용됩니다.

제공 기능:

• 계측 코어

  • 인라인 후킹: 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 페이지에서 다운로드하세요.