GhostLock-Galaxy

中文: README_ZH.md

هذا مستودع منفصل لأن هذا المسار يتطلب صلاحية shell على Android، يتم الحصول عليها عبر adb shell أو Shizuku. المستودع الأصلي YuKongA/ghostlock-app لا يستخدم صلاحية shell ويتبع مسار تنفيذ مختلف؛ لا ينبغي افتراض أن متطلباته ومسار الكود الخاص به قابلان للتبادل مع هذا المشروع.

ملفات تعريف النواة المسجلة

الجهاز	النواة
Samsung Galaxy Z Fold6 (SM-F9560 / q6q)	6.1.145-android14-11-3254009-abF9560ZCS4DZI1
Samsung Galaxy Z Fold6 (SM-F9560 / q6q)	6.1.145-android14-11-3254009-abF9560ZCS4DZH5
Samsung Galaxy Z Fold6 (SM-F9560 / q6q)	6.1.145-android14-11-3254009-abF9560ZCS4DZG3

عند بدء التشغيل تتم مطابقة النواة مع جدول الإزاحات عبر uname -r؛ يتم رفض النوى غير المدعومة فورًا.

البدء السريع

بالنسبة لمسار APK، ابدأ Shizuku عبر التصحيح اللاسلكي، وامنح GhostLock الصلاحية، ثم اضغط على Run. يقوم Shizuku بتشغيل الحمولة بصفة مستخدم shell على Android؛ تطبيق APK نفسه ليس سياق تنفيذ الاستغلال.

تصحيح الأخطاء عبر سطر الأوامر

يشغّل مسار سطر الأوامر المباشر نفس حمولة shell المُتحقق منها دون الحاجة إلى Shizuku:

make ghostlock helper
adb push ghostlock /data/local/tmp/ghostlock
adb push ghostlock-helper /data/local/tmp/ghostlock-helper
adb push app/src/main/assets/ksud /data/local/tmp/ksud
adb shell chmod 755 /data/local/tmp/ghostlock
adb shell chmod 755 /data/local/tmp/ghostlock-helper
adb shell chmod 755 /data/local/tmp/ksud
adb shell /data/local/tmp/ghostlock

يُطلب هذا المساعد من قِبل جذر UMH ومراحل التحميل المتأخر في KernelSU.

ملاحظات بناء KernelSU 6.1

في بعض نوى Samsung/Exynos 6.1، قد تُسبّب وحدة KernelSU العامة حالة panic في EL2 أثناء ksud late-load لأن الوحدة تحاول إجراء ترقيع نصي مباشر. بالنسبة للأهداف المتأثرة، ابنِ وحدة لإصدار البرنامج الثابت بالضبط وفعّل خيار no-patch-text في شجرة الهدف:

CONFIG_KSU_SAMSUNG_NO_PATCH_TEXT=y

قم بإقران kernelsu.ko و ksud الخاصين بالهدف، وطابق uname -r الكامل للجهاز بدلاً من 6.1 KMI فقط. قد يأتي إعادة التشغيل أثناء التحميل المتأخر من تهيئة الوحدة النمطية، وليس بالضرورة من محمّل ksud. هذا احتياط خاص بـ Samsung/Exynos؛ الهدف الحالي SM-F9560 هو Snapdragon ويجب التحقق منه بشكل منفصل. راجع Root-My-Galaxy-Payloads للحصول على أمثلة بناء خاصة بالهدف.

استخراج الإزاحات

على أجهزة Qualcomm، يقوم tools/extract_target.py بتحليل الإزاحات من boot.img و xbl_config.img. يتطلب Python 3 ومصدر kallsyms (ملف --kallsyms أو --kallsyms-finder). تمرير --llvm-objdump (أو وجود llvm-objdump على PATH/NDK) يقوم بالإضافة إلى ذلك بتفكيك النواة لاشتقاق pselect_waiter_shift و off_slide_loggers_0_1 تلقائيًا:

python tools/extract_target.py `
  boot.img `
  --xbl-config xbl_config.img `
  --format c `
  --out offsets.h

جدوى مسار pselect

ينسخ core_sys_select فقط 3 × FDS_BYTES(nfds) من بيانات fd_set الخاصة بالمستخدم إلى مكدس النواة (qwords 0..14 لـ nfds=320). يجب أن يقع منتظر futex داخل تلك المنطقة القابلة للتحكم: كلمة بداية المنتظر + 11 (حقل القفل) <= 14، أي أن الإزاحة المشتقة (إزاحة المنتظر من fd_set بوحدات qwords) يجب أن تكون <= 3، وإلا فإن المهمة/القفل يسقطان في الذيل المصفَّر من النواة ولا يمكن للمسار أن يعمل. يفشل السكربت بخطأ واضح عندما يكون التخطيط غير قابل للتنفيذ.

تفاصيل إضافية & المساهمات

تتوفر مزيد من التفاصيل حول أبحاث الحمولة والمواد الداعمة في Root-My-Galaxy-Payloads. طلبات السحب مرحب بها.

الشكر & الترخيص

استنادًا إلى المشاريع التالية، المرخّصة بموجب Apache License 2.0 (انظر LICENSE):

• NebuSec/CyberMeowfia
• JoinChang/ghostlock-oneplus
• x-spy/CVE-2026-43499-popsicle
• YuKongA/ghostlock-app
• BuSung-dev/Root-My-Galaxy