pongoOS

Un environnement d'exécution de pré-démarrage pour les cartes Apple construit sur checkra1n.

Compilation sur macOS

• Installez Xcode + les utilitaires en ligne de commande
• Exécutez make all

Compilation sur Linux

• Installez clang (en cas de doute, depuis apt.llvm.org)
• Installez ld64 et strip de cctools.
  • Sur Debian/Ubuntu, ils peuvent être installés depuis le dépôt 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
    

  • Sur les autres distributions Linux, vous devrez probablement les compiler vous-même. Peut-être que ce dépôt vous aidera.
• Exécutez make all

Si clang, ld64 ou cctools-strip n'ont pas leurs noms/chemins par défaut, vous voudrez modifier leur invocation. Pour référence, les variables par défaut sont équivalentes à :

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

Artefacts de compilation

Le Makefile créera quatre binaires dans build/ :

• Pongo - Un Mach-O du PongoOS principal
• Pongo.bin - Identique au précédent, mais en binaire nu pouvant être exécuté directement
• checkra1n-kpf-pongo - Le patchfinder du noyau de checkra1n, en tant que module Pongo (Mach-O/kext)
• PongoConsolidated.bin - PongoOS et le KPF fusionnés en un seul binaire

Utilisation

checkra1n -k Pongo.bin                  # Démarre sur le shell Pongo, KPF non disponible
checkra1n -k PongoConsolidated.bin      # Exécute automatiquement le KPF et démarre sur XNU
checkra1n -k PongoConsolidated.bin -p   # Charge le KPF, mais démarre sur le shell Pongo

Contributions

En soumettant une pull request, vous acceptez de licencier vos contributions sous la Licence MIT et vous certifiez que vous avez le droit de le faire.
Si vous souhaitez importer du code tiers qui ne peut pas être ainsi licencié, cela doit être noté de manière proéminente pour que nous puissions l'évaluer en conséquence.

Structure

• Le cœur de PongoOS et les pilotes se trouvent dans src/.
  • Les outils d'assistance de compilation sont dans tools/.
• La stdlib utilisée par PongoOS (Newlib) se trouve dans aarch64-none-darwin.
  • Cela inclut un correctif personnalisé pour que Newlib fonctionne avec l'ABI Darwin.
• Un exemple de module existe dans example/.
• Les scripts pour communiquer avec le shell PongoOS sont dans scripts/.
  • Cela inclut pongoterm, un client shell interactif pour macOS.
• Le patchfinder du noyau (KPF) de checkra1n se trouve dans checkra1n/kpf.
  • Cela inclut actuellement l'exploit SEP, bien que celui-ci doive être déplacé dans le PongoOS principal à l'avenir.
• Une version espace utilisateur du KPF peut être construite depuis checkra1n/kpf-test (ne peut être exécutée que sur arm64).