pongoOS

Um ambiente de execução pré-inicialização para placas Apple construído sobre o checkra1n.

Compilação no macOS

• Instale o Xcode + utilitários de linha de comando
• Execute make all

Compilação no Linux

• Instale o clang (se tiver dúvidas, a partir de apt.llvm.org)
• Instale o ld64 e o strip do cctools.
  • No Debian/Ubuntu estes podem ser instalados a partir do repositório do 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
    

  • Em outras distribuições Linux você provavelmente terá que compilá-los você mesmo. Talvez este repositório possa ajudar.
• Execute make all

Se clang, ld64 ou cctools-strip não tiverem seus nomes/caminhos padrão, você precisará alterar sua invocação. Para referência, as variáveis padrão são equivalentes a:

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

Artefatos de compilação

O Makefile criará quatro binários em build/:

• Pongo - Um Mach-O do PongoOS principal
• Pongo.bin - Igual ao acima, mas como um binário bare metal que pode ser acessado
• checkra1n-kpf-pongo - O kernel patchfinder do checkra1n, como um módulo Pongo (Mach-O/kext)
• PongoConsolidated.bin - PongoOS e o KPF fundidos em um único binário

Uso

checkra1n -k Pongo.bin                  # Inicializa no shell Pongo, KPF não disponível
checkra1n -k PongoConsolidated.bin      # Executa automaticamente o KPF e inicializa o XNU
checkra1n -k PongoConsolidated.bin -p   # Carrega o KPF, mas inicializa no shell Pongo

Contribuições

Ao enviar um pull request, você concorda em licenciar suas contribuições sob a Licença MIT e certifica que tem o direito de fazê-lo.
Se você quiser importar código de terceiros que não possa ser licenciado dessa forma, isso deverá ser anotado de forma proeminente para que possamos avaliar adequadamente.

Estrutura

• O núcleo do PongoOS e os drivers estão em src/.
  • Ferramentas auxiliares de compilação estão em tools/.
• A stdlib usada pelo PongoOS (Newlib) está em aarch64-none-darwin.
  • Isso inclui um patch personalizado para o Newlib funcionar com a ABI Darwin.
• Um módulo de exemplo existe em example/.
• Scripts para se comunicar com o shell PongoOS estão em scripts/.
  • Isso inclui o pongoterm, um cliente de shell interativo para macOS.
• O kernel patchfinder (KPF) do checkra1n está em checkra1n/kpf.
  • Atualmente, isso inclui o exploit do SEP, embora isso deva ser movido para o PongoOS principal no futuro.
• Uma versão de userland do KPF pode ser compilada a partir de checkra1n/kpf-test (só pode ser executada em arm64).