Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Support GPU Passthrough to VMs

未关闭
#106 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
停滞
技术栈
linux, rust

调研方向

首先检查现有的 FeOS VM API 和模型,然后跟踪负责设备配置的 hypervisor backend。定义 GPU PCIe-address API、验证、IOMMU/vfio-pci 处理方式以及集成测试方案;完成的标准是单 GPU 和多 GPU VMs 能向 guest 暴露可用设备,并且不可用设备能够安全失败。

由索引模型根据 Issue 内容生成。

描述

area/operatingsystem

Summary

This work item enables FeOS to attach one or more physical GPUs directly to a FeOS-managed Virtual Machine (VM) using PCIe passthrough.

This functionality is critical for supporting GPU-accelerated workloads such as Artificial Intelligence (AI), Machine Learning (ML), scientific computing, and high-performance graphics within VMs. The implementation will extend the VM API to allow specifying GPUs by their host PCIe address.


Scope

✅ In Scope
  • Extend the FeOS VM API to allow specifying one or more GPUs via their host PCIe address for attachment to a VM.
  • Implement the backend logic for PCIe passthrough of a complete physical GPU (e.g., using IOMMU / vfio-pci).
  • Ensure the guest VM can recognize the attached GPU and that appropriate vendor drivers (e.g., NVIDIA, AMD) can be installed and utilized.
  • Support for passing through multiple GPUs to a single VM.
❌ Out of Scope
  • GPU virtualization technologies like NVIDIA vGPU or AMD MxGPU (SR-IOV). This issue focuses exclusively on full device passthrough.
  • Live migration of VMs with attached GPUs.
  • Dynamic hot-plugging of GPUs. GPUs must be attached when the VM is created or started.
  • Host-side GPU driver installation and configuration. This issue assumes the host is correctly prepared for passthrough.

Responsible Areas

  • FeOS VM Management
  • FeOS API

Contributors

  • @guvenc
  • @MalteJ

Acceptance Criteria

  • API
    • The VM API is extended to accept a list of PCIe addresses for GPUs in the VM specification.
    • The API performs validation to ensure the specified PCIe devices exist and are available for passthrough.
  • VM Runtime & Guest OS
    • A VM can be successfully launched with one or more GPUs passed through to it.
    • The guest operating system correctly identifies the hardware of the passed-through GPU(s) (e.g., visible in lspci).
    • Vendor-specific drivers (e.g., NVIDIA driver) can be installed successfully inside the guest OS.
    • A GPU-accelerated application or utility (e.g., nvidia-smi, a CUDA/OpenCL sample) runs successfully within the VM and can access the GPU's capabilities.
    • The FeOS host correctly isolates the device, preventing host-level drivers from claiming it while it is assigned to a VM.

Action Items

  • Design the API extension in the VM model for specifying GPU devices.
  • Implement the backend logic to configure the hypervisor for GPU passthrough (e.g., managing IOMMU groups, binding to vfio-pci).
  • Ensure that all functions of a GPU (e.g., graphics and audio components on the same PCIe card) are passed through together.
  • Add robust validation and error handling for cases where a GPU is unavailable or passthrough fails.
  • Create integration tests that:
    • Launch a VM with a single GPU and verify its functionality in the guest.
    • Launch a VM with multiple GPUs and verify their functionality in the guest.
主要语言
Rust
星标
24
派生
9
PR 合并指标
30 天内没有已合并 PR

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

ironcore-dev/FeOS 的其他 Issue

查看 ironcore-dev/FeOS 的全部 Issue

相似的 Issue

更多 Rust Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。