> For the complete documentation index, see [llms.txt](https://book.ferro.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.ferro.pro/vt/intel_gvtg.md).

# Intel GVT-g

* [Requirements](#requirements)
* [Update tool](#update-tool)
* [Guide](#guide)
* [Kernel Compiling](#kernel-compiling)
  * [KVMGT](#kvmgt)
  * [XENGT](#xengt)
* [GRUB](#grub)
* [mdev](#mdev)
* [libvirt](#libvirt)
* [QEMU](#qemu)
* [Openstack](#openstack)

<https://01.org/sites/default/files/documentation/an\\_introduction\\_to\\_intel\\_gvt-g\\_for\\_external.pdf>

## Requirements

<https://wiki.archlinux.org/title/Intel\\_GVT-g\\>
only works with Intel Broadwell (5th gen) to Comet Lake (10th gen)\
For Xe Architecture (Gen12) based GPUs, SR-IOV feature is needed instead.

```
lspci -v -s 00:02.0
```

## Update tool

<https://download.01.org/gfx/repos/src/\\>
<https://01.org/linuxgraphics/downloads/intel-graphics-update-tool-linux-os-v2.0.5>

```
wget https://download.01.org/gfx/RPM-GPG-GROUP-KEY-ilg
sudo apt-key add RPM-GPG-GROUP-KEY-ilg

apt install -y libgtk-3-0
apt --fix-broken install
```

## Guide

<https://github.com/intel/gvt-linux/wiki/GVTg\\_Setup\\_Guide\\>
<https://www.kraxel.org/blog/2017/01/virtual-gpu-support-landing-upstream/>

## Kernel Compiling

```
CONFIG_DRM_I915_GVT
CONFIG_DRM_I915_GVT_KVMGT # KVMGT
CONFIG_DRM_I915_GVT_XENGT # XENGT
CONFIG_VFIO_MDEV
CONFIG_VFIO_MDEV_DEVICE
CONFIG_VFIO_IOMMU_TYPE1

cat .config | grep -P 'I915|VFIO|KVM'
lsmod | grep -P -i 'vfio|kvm|i915'
```

<https://download.01.org/GVT-g/>

### KVMGT

For KVMGT, you also can use the current upstream Linux kernel and QEMU directly since all the enabling patches have been upstreamed.\
<https://github.com/intel/gvt-linux/tree/gvt-staging/drivers/gpu/drm/i915/gvt>

```
https://github.com/intel/gvt-linux/releases (~150MB)
git clone -b gvt-stable-4.12 https://github.com/intel/gvt-linux.git  # >20G?
echo ""|make oldconfig
```

### XENGT

For XenGT, you must use the repositories we provided.\
<https://github.com/intel/Igvtg-xen/tree/xengt-stable-4.9/>

<https://github.com/intel/gvt-linux/wiki/GVTg\\_Setup\\_Guide#332-build-qemu--xen-for-xengt>

```
git clone -b xengt-stable-4.9 https://github.com/01org/igvtg-xen  # ~111MB
```

## GRUB

```
vi /etc/default/grub # KVMGT
    i915.hvm_boot_foreground=1 i915.enable_gvt=1 kvm.ignore_msrs=1 intel_iommu=igfx_off drm.debug=0
```

## mdev

```
ls /sys/bus/pci/devices/0000\:00\:02.0/mdev_supported_types/
    V4 means it is "Broadwell" platform, 
    V5 means it is "Skylake" or "Kabylake" platform

vgpu_create="/sys/bus/pci/devices/0000:00:02.0/mdev_supported_types/i915-GVTg_V5_4/create"
echo "a297db4a-f4c2-11e6-90f6-d3b88d6c9525" > $vgpu_create
ls /sys/bus/pci/devices/0000:00:02.0/

/sys/bus/pci/devices/0000:00:02.0/mdev_supported_types/i915-GVTg_V5_4/description
low_gm_size: 128MB
high_gm_size: 512MB
fence: 4
resolution: 1920x1200
weight: 4

/sys/bus/pci/devices/0000:00:02.0/mdev_supported_types/i915-GVTg_V5_8/description
low_gm_size: 64MB
high_gm_size: 384MB
fence: 4
resolution: 1024x768
weight: 2
```

## libvirt

```
<os>
    <loader readonly='yes' secure='no' type='rom'>/usr/bin/bios.bin</loader>

<domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'>
    <qemu:commandline>
        <qemu:arg value='-device'/>
        <qemu:arg value='vfio-pci,addr=05.0,sysfsdev=/sys/class/mdev_bus/0000:00:02.0/673475f6-cd28-11e7-9d1e-773e86af553a'/>
    </qemu:commandline>

https://mpolednik.github.io/2017/05/21/vfio-mdev/
Since 3.2.0
<devices>
    <hostdev mode='subsystem' type='mdev' model='vfio-pci'>
        <source>
            <address uuid='673475f6-cd28-11e7-9d1e-773e86af553a'/>
        </source>
    </hostdev>

https://libvirt.org/drvnodedev.html#MDEV (Since 3.4.0)

# workaround "error: cannot load AppArmor profile"
/etc/libvirtd/qemu.conf
    security_driver = "none"

# workaround 'error opening /dev/vfio/#: Permission denied'
sudo aa-complain /usr/sbin/libvirtd
sudo aa-complain /etc/apparmor.d/libvirt/libvirt-*
```

## QEMU

```
git clone -b stable-2.9.0 https://github.com/intel/Igvtg-qemu.git  # ~184MB
apt-get install -y libsdl2-dev libpixman-1-dev libspice-server-dev
qemu-system-x86_64 --version
```

## Openstack

<https://www.openstack.org/assets/presentation-media/Enable-GPU-virtualization-in-OpenStack.pdf>