pongoOS

checkra1n 上に構築された Apple ボード向けプリブート実行環境。

macOS でのビルド

Xcode とコマンドラインユーティリティをインストール
make all を実行

Linux でのビルド

clang をインストール (不明な場合は apt.llvm.org から)
ld64 と cctools の strip をインストール。
- 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/ に 4 つのバイナリを作成します:

Pongo - メインの PongoOS の Mach-O
Pongo.bin - 上記と同じですが、ジャンプ可能なベアメタルバイナリ
checkra1n-kpf-pongo - checkra1n カーネルパッチファインダー (Pongo モジュールとして、Mach-O/kext)
PongoConsolidated.bin - PongoOS と KPF を 1 つのバイナリに統合

使用方法

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

コントリビューション

プルリクエストを提出することにより、あなたのコントリビューションを MIT ライセンスの下でライセンスすることに同意し、その権利があることを証明するものとします。
そのようにライセンスできないサードパーティコードをインポートしたい場合は、その旨を目立つように記載してください。当方で適宜評価します。

構造

コアの PongoOS とドライバは src/ にあります。
- ビルド時のヘルパーツールは tools/ にあります。
PongoOS が使用する stdlib (Newlib) は aarch64-none-darwin にあります。
- これには Darwin ABI で動作するための Newlib のカスタムパッチが含まれています。
サンプルモジュールが example/ にあります。
PongoOS シェルと通信するためのスクリプトは scripts/ にあります。
- これには macOS 用のインタラクティブシェルクライアント pongoterm が含まれています。
checkra1n カーネルパッチファインダー (KPF) は checkra1n/kpf にあります。
- 現在これには SEP エクスプロイトが含まれていますが、将来的にはメインラインの PongoOS に移行される予定です。
KPF のユーザーランド版は checkra1n/kpf-test からビルドできます (arm64 でのみ実行可能)。

PongoOS

人気