手順D.1 IOMMU グループ

1. デバイスの一覧表示

   virsh nodev-list device-type コマンドを実行することにより、システムのデバイスを特定します。この例では、PCI デバイスを見つける方法を説明します。出力は簡潔にするために変更されています。

   # virsh nodedev-list pci
   
   pci_0000_00_00_0
   pci_0000_00_01_0
   pci_0000_00_03_0
   pci_0000_00_07_0
   [...]
   pci_0000_00_1c_0
   pci_0000_00_1c_4
   [...]
   pci_0000_01_00_0
   pci_0000_01_00_1
   [...]
   pci_0000_03_00_0
   pci_0000_03_00_1
   pci_0000_04_00_0
   pci_0000_05_00_0
   pci_0000_06_0d_0

2. デバイスの IOMMU グループの特定

   一覧表示される各デバイスについては、virsh nodedev-dumpxml name-of-device コマンドを使用すると、IOMMU グループを含むデバイスについての追加情報を参照できます。たとえば、IOMMU グループで pci_0000_04_00_0 という名前の PCI デバイス (PCI アドレス 0000:04:00.0) を検索する場合、以下のコマンドを使用します。

   # virsh nodedev-dumpxml pci_0000_04_00_0

   このコマンドは、以下に示すのと同様の XML ダンプを生成します。

   
   <device>
     <name>pci_0000_04_00_0</name>
     <path>/sys/devices/pci0000:00/0000:00:1c.0/0000:04:00.0</path>
     <parent>pci_0000_00_1c_0</parent>
     <capability type='pci'>
       <domain>0</domain>
       <bus>4</bus>
       <slot>0</slot>
       <function>0</function>
       <product id='0x10d3'>82574L Gigabit Network Connection</product>
       <vendor id='0x8086'>Intel Corporation</vendor>
       <iommuGroup number='8'>   <!--This is the element block you will need to use-->
         <address domain='0x0000' bus='0x00' slot='0x1c' function='0x0'/>
         <address domain='0x0000' bus='0x00' slot='0x1c' function='0x4'/>
         <address domain='0x0000' bus='0x04' slot='0x00' function='0x0'/>
         <address domain='0x0000' bus='0x05' slot='0x00' function='0x0'/>
       </iommuGroup>
       <pci-express>
         <link validity='cap' port='0' speed='2.5' width='1'/>
         <link validity='sta' speed='2.5' width='1'/>
       </pci-express>
     </capability>
   </device>

   図D.1 IOMMU グループ XML

3. PCI データの表示

   上記で収集される出力では、4 つのデバイスを含む 1 つの IOMMU グループがあります。これは、ACS サポートのないマルチファンクション PCIe root ポートの例です。スロット 0x1c の 2 つの機能は PCIe root ポートであり、これらは (pciutils パッケージにある) lspci コマンドを実行することによって特定できます。

   # lspci -s 1c
   
   00:1c.0 PCI bridge: Intel Corporation 82801JI (ICH10 Family) PCI Express Root Port 1
   00:1c.4 PCI bridge: Intel Corporation 82801JI (ICH10 Family) PCI Express Root Port 5
   

   エンドデバイスであるバス 0x04 および 0x05 の 2 つの PCIe デバイスについてこの手順を繰り返します。

   # lspci -s 4
   04:00.0 Ethernet controller: Intel Corporation 82574L Gigabit Network Connection これは次のステップで使用され、04:00.0 と呼ばれます。
   # lspci -s 5 これは次のステップで使用され、05:00.0 と呼ばれます。
   05:00.0 Ethernet controller: Broadcom Corporation NetXtreme BCM5755 Gigabit Ethernet PCI Express (rev 02)

4. エンドポイントのゲスト仮想マシンへの割り当て

   エンドポイントのいずれかを仮想マシンに割り当てるには、現時点で割り当てていないエンドポイントを VFIO 互換ドライバーにバインドして、IOMMU グループがユーザーおよびホストドライバー間で分離されないようにします。たとえば、上記で受信される出力では 04:00.0 のみを持つ仮想マシンを設定しようとしますが、マシンは 05:00.0 がホストドライバーから分離されない限り、起動に失敗します。05:00.0 の割り当てを解除するには、root で virsh nodedev-detach コマンドを実行します。

   # virsh nodedev-detach pci_0000_05_00_0
   Device pci_0000_05_00_0 detached

   両方のエンドポイントを仮想マシンに割り当てることは、この問題を解決するための別のオプションになります。libvirt は、<hostdev> 要素内の managed 属性に yes 値を使用する場合に、割り当てられたデバイスに対してこの操作を自動的に実行します。例: <hostdev mode='subsystem' type='pci' managed='yes'>。詳細については、注記 を参照してください。