pongoOS

بيئة تشغيل تمهيدية للوحات Apple مبنية على top من checkra1n.

البناء على macOS

• قم بتثبيت Xcode + أدوات سطر الأوامر
• قم بتشغيل make all

البناء على لينكس

• قم بتثبيت clang (إذا كنت في شك، من apt.llvm.org)
• قم بتثبيت ld64 و strip من cctools.
  • على Debian/Ubuntu يمكن تثبيتها من مستودع checkra1n:
    root@kitploit:~

    echo 'deb https://assets.checkra.in/debian /' | sudo tee /etc/apt/sources.list.d/checkra1n.list
    sudo apt-key adv --fetch-keys https://assets.checkra.in/debian/archive.key
    sudo apt-get update
    sudo apt-get install -y ld64 cctools-strip
    

  • على إصدارات لينكس الأخرى، ستحتاج على الأرجح إلى بنائها بنفسك. ربما هذا المستودع سيساعدك.
• قم بتشغيل make all

إذا كانت clang أو ld64 أو cctools-strip لا تحتوي على الأسماء/المسارات الافتراضية الخاصة بها، فستحتاج إلى تغيير استدعائها. للعلم، المتغيرات الافتراضية تعادل:

EMBEDDED_CC=clang EMBEDDED_LDFLAGS=-fuse-ld=/usr/bin/ld64 STRIP=cctools-strip make all

عناصر البناء

سينشئ ملف Makefile أربعة ملفات ثنائية في build/:

• Pongo - ملف Mach-O لـ PongoOS الرئيسي
• Pongo.bin - نفس ما سبق، ولكن كملف ثنائي معدني عاري يمكن القفز إليه
• checkra1n-kpf-pongo - مكتشف توابع kernel الخاص بـ checkra1n، كوحدة Pongo (Mach-O/kext)
• PongoConsolidated.bin - دمج PongoOS و KPF في ملف ثنائي واحد

الاستخدام

checkra1n -k Pongo.bin                  # يُشغّل إلى قشرة Pongo، KPF غير متاح
checkra1n -k PongoConsolidated.bin      # يُشغّل تلقائياً KPF ويُشغّل إلى XNU
checkra1n -k PongoConsolidated.bin -p   # يُحمل KPF، لكن يُشغّل إلى قشرة Pongo

المساهمات

بتقديم طلب سحب، فإنك توافق على ترخيص مساهماتك بموجب رخصة MIT وتؤكد أن لديك الحق في القيام بذلك.
إذا كنت ترغب في استيراد كود من طرف ثالث لا يمكن ترخيصه على هذا النحو، فيجب ذكر ذلك بشكل بارز حتى نقيمه وفقًا لذلك.

الهيكلية

• نواة PongoOS وبرامج التشغيل موجودة في src/.
  • أدوات مساعدة وقت البناء موجودة في tools/.
• المكتبة القياسية المستخدمة من قبل PongoOS (Newlib) موجودة في aarch64-none-darwin.
  • يتضمن ذلك تصحيحًا مخصصًا لـ Newlib ليعمل مع واجهة Darwin الثنائية للتطبيق (ABI).
• وحدة نموذجية موجودة في example/.
• البرامج النصية للتواصل مع قشرة PongoOS موجودة في scripts/.
  • يتضمن ذلك pongoterm، وهو عميل قشرة تفاعلي لنظام macOS.
• مكتشف توابع kernel الخاص بـ checkra1n (KPF) موجود في checkra1n/kpf.
  • يتضمن هذا حاليًا استغلال SEP، على الرغم من أنه من المقرر نقله إلى PongoOS الرئيسي في المستقبل.
• يمكن بناء نسخة مستخدم من KPF من checkra1n/kpf-test (يمكن تشغيلها فقط على arm64).