pongoOS

Un entorno de ejecución previo al arranque para placas Apple construido sobre checkra1n.

Compilación en macOS

• Instale Xcode + utilidades de línea de comandos
• Ejecute make all

Compilación en Linux

• Instale clang (si tiene dudas, desde apt.llvm.org)
• Instale ld64 y strip de cctools.
  • En Debian/Ubuntu se pueden instalar desde el repositorio de 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
    

  • En otras variantes de Linux probablemente tendrá que compilarlos usted mismo. Quizás este repositorio le sirva de ayuda.
• Ejecute make all

Si clang, ld64 o cctools-strip no tienen sus nombres/rutas predeterminados, querrá cambiar su invocación. Como referencia, las variables predeterminadas equivalen a:

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

Artefactos de compilación

El Makefile creará cuatro binarios en build/:

• Pongo - Un Mach-O del PongoOS principal
• Pongo.bin - Igual que el anterior, pero como un binario bare metal al que se puede saltar
• checkra1n-kpf-pongo - El kernel patchfinder de checkra1n, como módulo Pongo (Mach-O/kext)
• PongoConsolidated.bin - PongoOS y el KPF combinados en un único binario

Uso

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

Contribuciones

Al enviar un pull request, acepta licenciar sus contribuciones bajo la Licencia MIT y certifica que tiene derecho a hacerlo.
Si desea importar código de terceros que no pueda ser licenciado de esta manera, deberá indicarlo de forma destacada para que lo evaluemos en consecuencia.

Estructura

• El núcleo de PongoOS y los controladores están en src/.
  • Las herramientas auxiliares de compilación están en tools/.
• La stdlib utilizada por PongoOS (Newlib) está en aarch64-none-darwin.
  • Esto incluye un parche personalizado para que Newlib funcione con el ABI de Darwin.
• Existe un módulo de ejemplo en example/.
• Los scripts para comunicarse con el shell de PongoOS están en scripts/.
  • Esto incluye pongoterm, un cliente interactivo del shell para macOS.
• El kernel patchfinder (KPF) de checkra1n está en checkra1n/kpf.
  • Esto incluye actualmente el exploit SEP, aunque en el futuro se trasladará al PongoOS principal.
• Se puede compilar una versión en espacio de usuario del KPF desde checkra1n/kpf-test (solo se puede ejecutar en arm64).