pongoOS

Eine Pre-Boot-Ausführungsumgebung für Apple-Boards, die auf checkra1n basiert.

Erstellen auf macOS

• Installiere Xcode + Befehlszeilen-Dienstprogramme
• Führe make all aus

Erstellen auf Linux

• Installiere clang (im Zweifel von apt.llvm.org)
• Installiere ld64 und strip von cctools.
  • Auf Debian/Ubuntu können diese aus dem checkra1n-Repository installiert werden:
    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
    

  • Auf anderen Linux-Varianten wirst du sie wahrscheinlich selbst bauen müssen. Vielleicht hilft dir dieses Repository weiter.
• Führe make all aus

Wenn clang, ld64 oder cctools-strip nicht ihre Standardnamen/-pfade haben, solltest du ihre Aufrufe ändern. Als Referenz sind die Standardvariablen äquivalent zu:

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

Build-Artefakte

Das Makefile erstellt vier Binärdateien in build/:

• Pongo – Ein Mach-O des Haupt-PongoOS
• Pongo.bin – Wie oben, aber als Bare-Metal-Binärdatei, zu der gesprungen werden kann
• checkra1n-kpf-pongo – Der checkra1n-Kernel-Patchfinder als Pongo-Modul (Mach-O/kext)
• PongoConsolidated.bin – PongoOS und der KPF in einer einzigen Binärdatei zusammengeführt

Verwendung

checkra1n -k Pongo.bin                  # Startet zur Pongo-Shell, KPF nicht verfügbar
checkra1n -k PongoConsolidated.bin      # Startet KPF automatisch und bootet zu XNU
checkra1n -k PongoConsolidated.bin -p   # Lädt KPF, startet aber zur Pongo-Shell

Beiträge

Mit dem Einreichen eines Pull-Requests erklärst du dich damit einverstanden, deine Beiträge unter der MIT-Lizenz zu lizenzieren, und du bestätigst, dass du dazu berechtigt bist.
Wenn du Code von Drittanbietern importieren möchtest, der nicht so lizenziert werden kann, muss dies deutlich gekennzeichnet werden, damit wir entsprechend bewerten können.

Struktur

• Der Kern von PongoOS und die Treiber befinden sich in src/.
  • Hilfswerkzeuge zur Bauzeit befinden sich in tools/.
• Die von PongoOS verwendete Stdlib (Newlib) befindet sich in aarch64-none-darwin.
  • Dies enthält einen benutzerdefinierten Patch für Newlib, um mit dem Darwin-ABI zu funktionieren.
• Ein Beispielmodul existiert in example/.
• Skripte zur Kommunikation mit der PongoOS-Shell befinden sich in scripts/.
  • Dies beinhaltet pongoterm, einen interaktiven Shell-Client für macOS.
• Der checkra1n-Kernel-Patchfinder (KPF) befindet sich in checkra1n/kpf.
  • Dies beinhaltet derzeit den SEP-Exploit, der jedoch in Zukunft in den Haupt-PongoOS verschoben werden soll.
• Eine Userland-Version des KPF kann aus checkra1n/kpf-test erstellt werden (kann nur auf arm64 ausgeführt werden).