VulkanがNetBSDで利用可能に
Vulkan is now available on NetBSD (github.com)
要約
このプロジェクトは、Vulkanソフトウェアスタック(Mesa / Lavapipe)をNetBSDに移植し、そのプロセスを文書化・自動化することを目指しています。現在、Lavapipe VulkanドライバーはNetBSD 10.1 amd64上でビルド、インストール、登録が可能であり、プロセス全体が自動化され再現可能になっています。将来的には、Vulkanローダーの導入とプリビルドバイナリの提供が予定されています。
全文翻訳
vulkan-netbsd
Vulkanソフトウェアスタック(Mesa / Lavapipe)をNetBSDに移植し、そのプロセスを文書化・自動化して再現・維持可能にする取り組みです。
ステータス: ベータ版。Lavapipe VulkanドライバがNetBSD上でビルド、インストール、登録されました
マイルストーン達成: MesaがNetBSD 10.1 amd64上で、LLVM 19.1.7を対象に、LavapipeソフトウェアVulkanドライバの設定、コンパイル、リンク、インストール、および登録を行いました。ドライバ(
libvulkan_lvp.so、約17MB)は/usr/pkg/libにインストールされ、そのICDマニフェスト(Vulkan API 1.4をアドバタイズ)は/usr/pkg/share/vulkan/icd.d/にインストールされるため、システム上のVulkanローダーがそれを検出できます。lddはすべての依存関係をクリーンに解決します。プロセス全体(環境設定、依存関係のビルド、Mesaのビルド、およびインストール)はエンドツーエンドで自動化されており、新規インストールでも再現可能です。ビルド済みバイナリが登場します。 ビルド済み成果物をビルド、フィンガープリント、公開するためのツールが整備されており、ビルドスクリプトはソースからビルドする代わりに、対応するビルド済みバイナリを取得してインストールする方法をすでに把握しています。ビルドマシンがリリースを公開し始めれば、ドライバのインストールは数時間かかるビルドではなく、ダウンロードになります。これが短期的な方向性です。
これは(まだ)何ではありません:
- Vulkanプログラムの実行にはローダーが必要です。 このプロジェクトはVulkan ドライバ(Lavapipe ICD)をビルド・インストールします。実際にVulkanアプリケーションを実行するには、Vulkan ローダー(
libvulkan.so.1)も必要ですが、これは次に立ち上げるコンポーネントです。したがって、実行時の動作はまだ検証されていません。- 1つの回避策がまだ残っています。 ビルドでは、GCCがNetBSD上のMesaの
%mフォーマット指定子を拒否するのを回避するために-Wno-error=formatを適用しています。適切なアップストリーム可能な修正(strerror(errno)を使用)が保留中です。
ローダーとリリースパイプラインが連携するにつれて、手順、スクリプト、ドキュメントは変更され続けます。
目標
NetBSDは現在、Vulkanサポートを持たない主要なBSD系OSの中で唯一のものです。このプロジェクトの目的は以下の通りです。
- NetBSD上でVulkanソフトウェアスタック(LLVM経由でCPU上で動作し、GPUを必要としないMesaのLavapipeドライバ)をビルドする。
- 行き詰まった点も含め、すべての手順を文書化し、プロセスを再現可能にする。
- セットアップを自動化し、数個のスクリプトで新規マシンをビルド準備状態にできる。
- 最終的に必要な修正をアップストリーム(Mesaおよびpkgsrc)にフィードし、ビルド済みバイナリまたはpkgsrcパッケージを提供して、NetBSD上のVulkanをソースからビルドするのではなく、単にインストールできるものにする。
スコープと環境
- 対象OS: NetBSD 10.1 (amd64)、最小ISOインストール。
- ホスト: VirtualBox VM。
- ビルド目標のみ: これはVulkanスタックのコンパイルとリンクを対象としています。VirtualBox下では実行時のGPUアクセラレーションは利用できません。ソフトウェアドライバ(Lavapipe)が対象です。
リポジトリレイアウト
vulkan-netbsd/
├── docs/
│ ├── 01-environment-setup.md ベースシステム + pkgsrc + ビルド依存関係
│ ├── 02-source-dependencies.md pkgsrcにない依存関係(ソースからビルド)
│ ├── 03-mesa-build.md Mesaの設定 + コンパイル(Lavapipe); ポートノート
│ └── 04-prebuilt-artifacts.md 一度ビルド / ビルド済みバイナリの再利用
└── scripts/
├── setup-env.sh 環境設定を自動化
├── build-glslang.sh glslangをビルド(Mesaに必要、pkgsrcにない)
├── build-mesa.sh Mesaをクローン + 設定 + コンパイル(Lavapipe)
├── install-mesa.sh ビルド済みドライバ + ICDマニフェストをインストール
├── lib-artifacts.sh 共有: フィンガープリント + ビルド済み取得ヘルパー
└── package-artifacts.sh ビルド済みバイナリをリリースtarballにパッケージ化
始め方
新規の最小NetBSD 10.1 (amd64) インストール上で、rootとして以下を実行します。
cd /root
ftp https://raw.githubusercontent.com/segaboy/vulkan-netbsd/main/scripts/setup-env.sh
sh setup-env.sh
. /root/.profile
ftp https://raw.githubusercontent.com/segaboy/vulkan-netbsd/main/scripts/build-glslang.sh
sh build-glslang.sh
ftp https://raw.githubusercontent.com/segaboy/vulkan-netbsd/main/scripts/build-mesa.sh
sh build-mesa.sh --build
ftp https://raw.githubusercontent.com/segaboy/vulkan-netbsd/main/scripts/install-mesa.sh
sh install-mesa.sh
build-mesa.sh --buildはMesaをクローン、設定、コンパイルし、Lavapipe Vulkanドライバ(libvulkan_lvp.so)を生成します。install-mesa.shはその後、そのドライバとICDマニフェストを/usr/pkgにインストールし、登録を確認します。
ビルドが中断されたり、マシンがクラッシュしたりした場合でも、同じコマンドを再実行すれば、ビルドスクリプトが既存のビルドを検出し、自動的に再開します。
これらのスクリプトを組み合わせることで、新規の最小インストールから、インストールおよび登録済みのVulkanソフトウェアドライバまでを完了できます。
完全なコメント付きウォークスルーとSSHでの実行に関するノートについては、docs/01-environment-setup.mdを参照してください。
貢献 / フォロー
これは個人的な進行中の作業です。変更が頻繁に発生する可能性があります。ドキュメントは実際に機能したこと(および機能しなかったこと)の記録として書かれているため、同じポートを試みる人にとってはフィールドノートとしても機能します。
ライセンス
このリポジトリ内の元の作業、スクリプト、ドキュメント、およびここで作成されたパッチは、MITライセンス(LICENSEを参照)の下で公開されています。
このプロジェクトは、そのライセンスの対象とならないサードパーティソフトウェアをビルド、インストール、および(オプションで)再配布しており、それらは独自のライセンスを保持しています。
- Mesa: 主にMITライセンス(一部コンポーネントは他の許容ライセンス下)。
- glslang: 許容ライセンス(BSDスタイル、Apache 2.0、およびKhronos条件)。
- LLVM: LLVM例外付きApache 2.0。LLVMはpkgsrc経由で別途インストールされ、このプロジェクトでは再配布されません。
scripts/package-artifacts.shによって生成されたビルド済み成果物は、関連するアップストリームライセンステキスト(share/licenses/の下)をバンドルしているため、バイナリ再配布は各プロジェクトの帰属表示を維持します。成果物を公開する場合は、これらのファイルをそのまま保持してください。