pongoOS

Un ambiente di esecuzione pre-boot per schede Apple costruito su checkra1n.

Compilazione su macOS

• Installa Xcode + utility da riga di comando
• Esegui make all

Compilazione su Linux

• Installa clang (in caso di dubbio, da apt.llvm.org)
• Installa ld64 e strip di cctools.
  • Su Debian/Ubuntu possono essere installati dal repository 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
    

  • Su altre distribuzioni Linux probabilmente dovrai compilarli tu stesso. Forse questo repository ti aiuterà.
• Esegui make all

Se clang, ld64 o cctools-strip non hanno i nomi/percorsi predefiniti, dovrai modificare la loro invocazione. Per riferimento, le variabili predefinite sono equivalenti a:

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

Artefatti di build

Il Makefile creerà quattro binari in build/:

• Pongo - Un Mach-O del PongoOS principale
• Pongo.bin - Come sopra, ma come binario bare metal a cui si può saltare
• checkra1n-kpf-pongo - Il kernel patchfinder di checkra1n, come modulo Pongo (Mach-O/kext)
• PongoConsolidated.bin - PongoOS e il KPF fusi in un singolo binario

Utilizzo

checkra1n -k Pongo.bin                  # Boots to Pongo shell, KPF not available
checkra1n -k PongoConsolidated.bin      # Auto-runs KPF and boots to XNU
checkra1n -k PongoConsolidated.bin -p   # Loads KPF, but boots to Pongo shell

Contributi

Inviando una pull request, accetti di concedere in licenza i tuoi contributi secondo la Licenza MIT e certifichi di avere il diritto di farlo.
Se desideri importare codice di terze parti che non può essere concesso in licenza in questo modo, ciò deve essere segnalato in modo prominente affinché possiamo valutarlo di conseguenza.

Struttura

• Il core di PongoOS e i driver sono in src/.
  • Gli strumenti ausiliari di compilazione sono in tools/.
• La stdlib utilizzata da PongoOS (Newlib) è in aarch64-none-darwin.
  • Questo include una patch personalizzata per Newlib per funzionare con l'ABI Darwin.
• Un modulo di esempio esiste in example/.
• Gli script per comunicare con la shell di PongoOS sono in scripts/.
  • Questo include pongoterm, un client shell interattivo per macOS.
• Il kernel patchfinder (KPF) di checkra1n è in checkra1n/kpf.
  • Questo attualmente include l'exploit SEP, anche se in futuro dovrebbe essere spostato nel PongoOS principale.
• Una versione userland del KPF può essere compilata da checkra1n/kpf-test (può essere eseguita solo su arm64).