HvLoader 概要

HvLoader.efi は、外部のハイパーバイザローダーをロードするための EFI アプリケーションです。

HvLoader.efi は指定されたハイパーバイザローダーバイナリ (DLL, EFI など) をロードし、HvLoader.efi の ImageHandle を渡してそのエントリポイントを呼び出します。これにより、ハイパーバイザローダーバイナリは HvLoader.efi のコマンドラインオプションにアクセスし、それらを設定パラメータとして使用できます。最初の HvLoader.efi コマンドラインオプションは、ハイパーバイザローダーバイナリへのパスです。

現在、HvLoader.efi は efi パーティション (つまり /boot/efi) にあり、そのパーティションのみにアクセスできます。したがって、すべてのパス引数は /boot/efi パーティションからの相対パスである必要があります。この制限は将来のアップデートで緩和される可能性があります。

典型的な HvLoader.efi grub コマンドは次のようになります。

chainloader /HvLoader.efi \lxhvloader.dll MSHV_ROOT=\Windows MSHV_ENABLE=1 MSHV_SCHEDULER_TYPE=0 ...

ビルド環境のセットアップ

HvLoader.efi は TianoCore EDK2 でビルドされます。 ビルド環境は当初 Ubuntu 22.04.1 LTS でテストされましたが、Microsoft Windows、macOS、Unix でもセットアップ可能です。
詳細については、EDK2 の入門 を参照してください。

Linux では、Native GCC で EDK2 を使用する の指示に従い、最後に Linux 用の一般的な EDK II ビルド手順 に従ってリポジトリをクローンしてビルドしてください。

HvLoader.efi のビルド

HvLoader.efi は MdeModulePkg 内のアプリケーションとして存在します (つまり /MdeModulePkg/Application/HvLoader)。

EDK2 のビルドが成功したら、以下の手順に従って edk2 のルートディレクトリから実行することで HvLoader.efi をビルドできます。

1. pushd MdeModulePkg/Application

2. git clone https://github.com/asherkariv/HvLoader.git

3. popd

4. MdeModulePkg に HvLoader を追加:

   • MdeModulePkg/MdeModulePkg.dsc を編集
   • 例として、[Components] セクションに MdeModulePkg/Application/HvLoader/HvLoader.inf を追加してください:
     [Components]
     MdeModulePkg/Application/HelloWorld/HelloWorld.inf MdeModulePkg/Application/HvLoader/HvLoader.inf MdeModulePkg/Application/DumpDynPcd/DumpDynPcd.inf MdeModulePkg/Application/MemoryProfileInfo/MemoryProfileInfo.inf ...

5. HvLoder.efi をビルド:
   build -p MdeModulePkg/MdeModulePkg.dsc -m MdeModulePkg/Application/HvLoader/HvLoader.inf

6. ターゲット構成 (DEBUG/RELEASE) に応じて、HvLoader.efi は次の場所に生成されます。
   Build/MdeModule/DEBUG_GCC5/X64/HvLoader.efi
   または
   Build/MdeModule/RELEASE_GCC5/X64/HvLoader.efi

HvLoader.efi の署名

HvLoader.efi はセキュアブートのために署名する必要があります。