|
|
| (3 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| This page will keep a running list of components used to achieve GPU Virtualization.<blockquote>An absence of critical technical documentation has historically slowed growth and adoption of developer ecosystems for GPU virtualization.
| | {{About message}} |
|
| |
|
| This [https://creativecommons.org/licenses/by/4.0/ CC-BY-4.0] licensed content can either be used with attribution, or used as inspiration for new documentation, created by GPU vendors for public commercial distribution as developer documentation.
| | {{Superseded}} |
| | = GPU Software Bill Of Materials (SBOM) = |
|
| |
|
| Where possible, this documentation will clearly label dates and versions of observed-but-not-guaranteed behaviour vs. vendor-documented stable interfaces/behaviour with guarantees of forward or backward compatibility.</blockquote>
| | <blockquote>'''This page is superseded.''' The previous content was an imported 2023 wiki survey of third-party GPU-virtualization components. The complete, repository-scoped SBOM now lives at:</blockquote> |
| {| class="wikitable"
| |
| |+Component Table
| |
| !Vendor
| |
| !Component
| |
| !Description
| |
| !Version
| |
| !OSS or Blob
| |
| !Filesize
| |
| !Vendor Docs
| |
| !Release Date
| |
| !Interfaces / APIs
| |
| !Notes
| |
| |-
| |
| |Microsoft
| |
| |Indirect Display Driver (IDD)
| |
| |Driver
| |
| |
| |
| |[https://github.com/Microsoft/Windows-driver-samples/tree/main/video/IndirectDisplay OSS]
| |
| |
| |
| |[https://learn.microsoft.com/en-us/windows-hardware/drivers/display/indirect-display-driver-model-overview Indirect Display Driver Overview]
| |
| |
| |
| |[https://learn.microsoft.com/en-us/windows-hardware/drivers/wdf/overview-of-the-umdf UMDF], [https://learn.microsoft.com/en-us/windows-hardware/drivers/kernel/ KMDF]
| |
| |The Indirect Display Driver (IDD) enables GPUs to render graphics at arbitrary resolutions without a physical display connected on Windows OS systems.
| |
| |-
| |
| | rowspan="2" |RedHat
| |
| |vfio_pci
| |
| |Driver
| |
| |6.2-rc1
| |
| |[https://github.com/torvalds/linux/tree/master/drivers/vfio/pci OSS]
| |
| |in-kernel
| |
| |[https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/5/html/virtualization/chap-virtualization-pci_passthrough RedHat], [https://docs.kernel.org/driver-api/vfio.html kernel.org]
| |
| |2022.12.15
| |
| |[https://open-iov.org/index.php/Virtual_I/O_Internals#Instruction_Execution irqfd], [https://open-iov.org/index.php/Virtual_I/O_Internals#Instruction_Execution ioeventfd], [https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core.git/tree/Documentation/driver-api/ioctl.rst IOCTL]
| |
| |Reference VFIO Stub driver used for discrete assignment of IO, and assignment of some SR-IOV-backed vGPU devices into virtual machines. This driver is commonly replaced with a vendor built VFIO interface with differing memory management and/or page pinning mechanisms which are specific to the vGPU software internals.
| |
| |-
| |
| |Mediated Core (mdev.ko)
| |
| |Driver
| |
| |6.2-rc1
| |
| |OSS
| |
| |0.044 MB
| |
| |[https://docs.kernel.org/driver-api/vfio-mediated-device.html kernel.org]
| |
| |2016.xx.xx
| |
| |[https://open-iov.org/index.php/Virtual_I/O_Internals#Instruction_Execution irqfd], [https://open-iov.org/index.php/Virtual_I/O_Internals#Instruction_Execution ioeventfd], [https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core.git/tree/Documentation/driver-api/ioctl.rst IOCTL], [https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_DMA_Translations Type 1 IOMMU]
| |
| |The Mediated Core driver provides a common interface for mediated device management that can be used by drivers of different devices. It is an IOMMU/device-agnostic framework for exposing direct device access to user space in a secure, IOMMU-protected environment (based on VFIO).
| |
| |-
| |
| | rowspan="2" |Arc Compute
| |
| |gvm-guest
| |
| | rowspan="2" |Daemon
| |
| |0.1.0
| |
| |[https://github.com/Open-IOV/GVM-guest OSS]
| |
| |
| |
| |[https://docs.linux-gvm.org/gvm-guest docs.linux-gvm.org/gvm-guest]
| |
| |2023.02.08
| |
| |[https://fedoraproject.org/wiki/Features/VirtioSerial Virtio-Serial], CLI
| |
| |Handles IO to and from guests and the host using Virtio-Serial to handle multiple different guest modules.
| |
| |-
| |
| |gvm-cli
| |
| |1.0
| |
| |[https://github.com/Open-IOV/GVM-user OSS]
| |
| |0.084 MB
| |
| |[https://docs.linux-gvm.org/gvm-user docs.linux-gvm.org/gvm-user]
| |
| |2023.01.06
| |
| |CLI, [https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core.git/tree/Documentation/driver-api/ioctl.rst IOCTL], [https://open-iov.org/index.php/GPU_Driver_Internals#RM_API RMAPI], [https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_Core Mediated Core]
| |
| |Configures the the [https://open-iov.org/index.php/GPU_Driver_Internals#nvidia-vgpu-mgr nvidia-vgpu-mgr] process.
| |
| |-
| |
| | rowspan="4" |Intel
| |
| |i915 SR-IOV
| |
| |Driver
| |
| | rowspan="3" |[https://github.com/intel/linux-intel-lts/tree/5.15/ADL-linux-ER 5.15]
| |
| |OSS
| |
| |in-kernel
| |
| |
| |
| |
| |
| |
| |
| |Intel's open source GPU driver for [https://open-iov.org/index.php/GPU_Firmware#GuC GuC]-equipped graphics accelerators.
| |
| |-
| |
| |[https://open-iov.org/index.php/GPU_Firmware#GuC GuC] μOS
| |
| | rowspan="2" |Firmware
| |
| | rowspan="2" |Blob
| |
| |
| |
| |
| |
| |
| |
| |IOMMU Interrupts, Power Management Interrupts, [https://open-iov.org/index.php/GPU_Driver_Internals#GTT_(Graphics_Translation_Table) GTT]
| |
| |Handles scheduling, and power management.
| |
| |-
| |
| |HuC
| |
| |
| |
| |
| |
| |
| |
| |[https://open-iov.org/index.php/GPU_Driver_Internals#GTT_(Graphics_Translation_Table) GTT]
| |
| |Handles video encoding/decoding.
| |
| |-
| |
| |[https://open-iov.org/index.php/GPU_Driver_Internals#Display_Surface_Virtualization_2 Display Virtualization for Windows OS]
| |
| |Driver
| |
| |[https://github.com/intel/Display-Virtualization-for-Windows-OS/releases/ 791]
| |
| |[https://github.com/intel/Display-Virtualization-for-Windows-OS OSS]
| |
| |
| |
| |[https://github.com/intel/Display-Virtualization-for-Windows-OS/blob/main/Readme.txt github.com/intel/Display-Virtualization-for-Windows-OS/blob/main/Readme.txt]
| |
| |
| |
| |[https://github.com/ikwzm/udmabuf udmabuf], [https://learn.microsoft.com/en-us/windows-hardware/drivers/wdf/overview-of-the-umdf UMDF], [https://learn.microsoft.com/en-us/windows-hardware/drivers/kernel/ KMDF]
| |
| |Intel's 'Display Virtualization for Windows OS' provides a virtual pixel surface used for hardware graphics rendering using Microsoft's open source 'Indirect Display Driver (IDD)'. Display virtualization for Windows OS makes use of display memory sharing primitives provided in-driver by the i915 host.
| |
| |-
| |
| | rowspan="7" |Nvidia
| |
| |[[OpenRM]]
| |
| |Driver
| |
| | rowspan="2" |525.85.12
| |
| |OSS
| |
| |
| |
| |[https://github.com/NVIDIA/open-gpu-kernel-modules/blob/main/README.md github.com/NVIDIA/open-gpu-kernel-modules/blob/main/README.md]
| |
| |2023.01.31
| |
| |
| |
| |Nvidia's open source GPU driver for [https://open-iov.org/index.php/GPU_Firmware#GSP GSP]-equipped graphics accelerators.
| |
| |-
| |
| |[https://open-iov.org/index.php/GPU_Firmware#GSP GSP] RM (uproc)
| |
| | rowspan="2" |Firmware
| |
| | rowspan="2" |Blob
| |
| |
| |
| |
| |
| |2023.01.31
| |
| |RPC
| |
| |Embedded firmware based on [https://lwn.net/Articles/637658/ LibOS] containing the [https://open-iov.org/index.php/GPU_Driver_Internals#RM_Core RM Core].
| |
| |-
| |
| |Falcon/NvRISC (uproc)
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |FBIF (Frame Buffer Interface) / GMMU
| |
| |Embedded firmware which handles many aspects of the device including configuring the GPU's GMMU controller.
| |
| |-
| |
| |nvidia-vgpud
| |
| | rowspan="2" |Daemon
| |
| | rowspan="4" |[https://docs.nvidia.com/grid/15.0/whats-new-vgpu/index.html v15.2]
| |
| | rowspan="4" |Blob
| |
| |0.108 MB
| |
| | rowspan="4" |[https://docs.nvidia.com/grid/index.html docs.nvidia.com/grid]
| |
| |2023.01.xx
| |
| |CLI, [https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core.git/tree/Documentation/driver-api/ioctl.rst IOCTL], [https://open-iov.org/index.php/GPU_Driver_Internals#RM_API RMAPI], [https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_Core Mediated Core]
| |
| |Configures the the [https://open-iov.org/index.php/GPU_Driver_Internals#nvidia-vgpu-mgr nvidia-vgpu-mgr] process.
| |
| |-
| |
| |nvidia-vgpu-mgr
| |
| |0.132 MB
| |
| |2023.01.xx
| |
| |[https://open-iov.org/index.php/GPU_Driver_Internals#vmiop vmiop], [https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core.git/tree/Documentation/driver-api/ioctl.rst IOCTL], [https://open-iov.org/index.php/GPU_Driver_Internals#RM_API RMAPI], [https://open-iov.org/index.php/GPU_Driver_Internals#Guest_kernel_(nvidia.ko) vRPC], pRPC, [https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_Core Mediated Core]
| |
| |Handles IO to and from guest RM, host RM, and hardware.
| |
| |-
| |
| |libnvidia-vgpu.so
| |
| |Library
| |
| |3.1 MB
| |
| |2023.01.xx
| |
| |[https://open-iov.org/index.php/GPU_Driver_Internals#vmiop vmiop], [https://open-iov.org/index.php/GPU_Driver_Internals#RM_API RMAPI], [https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_Core Mediated Core]
| |
| |Handles IO to and from guest RM, host RM, and hardware. Contains circular dependancies with [https://open-iov.org/index.php/GPU_Driver_Internals#nvidia-vgpu-mgr nvidia-vgpu-mgr].
| |
| |-
| |
| |nvidia-vgpu-vfio.ko
| |
| |Driver
| |
| |0.108 MB
| |
| |2023.01.xx
| |
| |[https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_DMA_Translations Type 1 IOMMU], [https://open-iov.org/index.php/Virtual_I/O_Internals#Instruction_Execution irqfd, ioeventfd], [https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core.git/tree/Documentation/driver-api/ioctl.rst IOCTL], [https://open-iov.org/index.php/Virtual_I/O_Internals#Mediated_Core Mediated Core]
| |
| |Handles incremental memory mapping (non-page pinning per the standard vfio-pci driver).
| |
| |}
| |
|
| |
|
| == More Information ==
| | * '''[https://git.vgpu.io/open-iov.git/tree/SBOM.md <code>SBOM.md</code>]''' — human-readable SBOM: primary component, first-party components, bundled third-party components with SHA-256 hashes, archived-documentation provenance, external build/run dependencies, dependency graph, license/redistribution terms, and the NTIA minimum-elements checklist. |
| | * '''[https://git.vgpu.io/open-iov.git/tree/sbom/open-iov-0.1.0.cdx.json <code>sbom/open-iov-0.1.0.cdx.json</code>]''' — machine-readable CycloneDX 1.6 SBOM (serial <code>urn:uuid:e626c5a1-9697-4546-bb2b-5b4feb58e922</code>). |
|
| |
|
| # [https://riscv.org/wp-content/uploads/2016/07/Tue1100_Nvidia_RISCV_Story_V2.pdf Nvidia RISC-V Story]
| | The SBOM covers every file tracked in this repository plus the external components required to build, run and support it. NVIDIA drivers, GSP firmware and CUDA packages are documented but '''not distributed''' here. |
| # [https://linux-gvm.org linux-gvm.org]
| |
| #[https://01.org/linuxgraphics/documentation/hardware-specification-prms Intel Graphics Programmer's Reference Manuals (PRM)]
| |
| #[https://bwidawsk.net/blog/2013/1/i915-hardware-contexts-and-some-bits-about-batchbuffers/ i915: Hardware Contexts (and some bits about batchbuffers)]
| |
| #[https://bwidawsk.net/blog/2014/6/the-global-gtt-part-1/ i915: The Global GTT Part 1]
| |
| #[https://bwidawsk.net/blog/2014/6/aliasing-ppgtt-part-2/ i915: Aliasing PPGTT Part 2]
| |
| #[https://bwidawsk.net/blog/2014/7/true-ppgtt-part-3/ i915: True PPGTT Part 3]
| |
| #[https://bwidawsk.net/blog/2014/7/future-ppgtt-part-4-dynamic-page-table-allocations-64-bit-address-space-gpu-mirroring-and-yeah-something-about-relocs-too/ i915: Future PPGTT Part 4 (Dynamic page table allocations, 64 bit address space, GPU "mirroring", and yeah, something about relocs too)]
| |
| #[https://igor-blue.github.io/2021/02/10/graphics-part1.html i915: Security of the Intel Graphics Stack - Part 1 - Introduction]
| |
| #[https://igor-blue.github.io/2021/02/24/graphics-part2.html i915: Security of the Intel Graphics Stack - Part 2 - FW <-> GuC]
| |
| #[https://01.org/sites/default/files/documentation/an_introduction_to_intel_gvt-g_for_external.pdf i915: An Introduction to Intel GVT-g (with new architecture)]
| |