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. يتوفر configure.bat لمستخدمي Windows.

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

شغّل configure مع --help لرؤية جميع الخيارات.

الاختبار

تُبنى الاختبارات باستخدام make test وتُشغّل باستخدام ./build/tests/gum-tests. يمكنك تحديد مسار اختبار باستخدام -p لتشغيل اختبار معين أو مجموعة من الاختبارات.

تتبع مسارات الاختبار النمط /<Area>/<Module>/<test_name> حيث تأتي المنطقة/الوحدة من وحدات ماكرو TESTENTRY في ملفات fixture (مثل TESTENTRY_WITH_FIXTURE("Core/Interceptor", ...)).

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

الملفات الثنائية

نزّل devkit للربط الساكن في مشاريعك الخاصة من صفحة releases الخاصة بـ Frida.