# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://book.ferro.pro/vt/intel_gvtg.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.