pongoOS

Среда выполнения до загрузки для плат Apple, построенная на основе checkra1n.

Сборка на macOS

Установите Xcode + утилиты командной строки
Выполните make all

Сборка на Linux

Установите clang (если сомневаетесь, из apt.llvm.org)
Установите ld64 и strip из cctools.
- На Debian/Ubuntu их можно установить из репозитория checkra1n:
```
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
```
- На других дистрибутивах Linux, скорее всего, придется собирать их самостоятельно. Возможно, этот репозиторий вам поможет.
Выполните make all

Если clang, ld64 или cctools-strip не имеют стандартных имен/путей, вам нужно изменить их вызов. Для справки, переменные по умолчанию эквивалентны:

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

Артефакты сборки

Makefile создаст четыре бинарных файла в build/:

Pongo — Mach-O основной PongoOS
Pongo.bin — То же, что выше, но как бинарный файл для голого металла, на который можно перейти
checkra1n-kpf-pongo — Патч-финдер ядра checkra1n, как модуль Pongo (Mach-O/kext)
PongoConsolidated.bin — PongoOS и KPF, объединенные в один бинарный файл

Использование

checkra1n -k Pongo.bin                  # Загружает оболочку Pongo, KPF недоступен
checkra1n -k PongoConsolidated.bin      # Автоматически запускает KPF и загружает XNU
checkra1n -k PongoConsolidated.bin -p   # Загружает KPF, но загружает оболочку Pongo

Вклад

Отправляя запрос на слияние, вы соглашаетесь лицензировать свои изменения под MIT License и подтверждаете, что имеете на это право.
Если вы хотите импортировать сторонний код, который не может быть лицензирован таким образом, это должно быть явно отмечено, чтобы мы могли оценить это соответствующим образом.

Структура

Ядро PongoOS и драйверы находятся в src/.
- Вспомогательные инструменты времени сборки находятся в tools/.
Стандартная библиотека, используемая PongoOS (Newlib), находится в aarch64-none-darwin.
- Она включает пользовательский патч для Newlib для работы с ABI Darwin.
Пример модуля находится в example/.
Скрипты для взаимодействия с оболочкой PongoOS находятся в scripts/.
- Сюда входит pongoterm — интерактивный клиент оболочки для macOS.
Патч-финдер ядра checkra1n (KPF) находится в checkra1n/kpf.
- В настоящее время он включает эксплойт SEP, хотя в будущем он будет перенесен в основную ветку PongoOS.
Пользовательская версия KPF может быть собрана из checkra1n/kpf-test (может быть запущена только на arm64).

PongoOS

Популярное