From 68cdd7728a7cc6715bbbff7decfe2b11c3bdf558 Mon Sep 17 00:00:00 2001 From: Open-IOV Date: Wed, 23 Sep 2026 05:44:08 -0400 Subject: Open-IOV: initial public release Open-IOV virtualizes NVIDIA GPUs so that unmodified guest drivers run with real GPU functionality - CUDA first, 3D and video to follow - on unmodified hosts, without a proprietary vGPU license and without patching any driver, firmware or hypervisor. Core principle: emulate the interface, pass through the work. kernel/ open-iov-vfio.ko - host VFIO mdev driver: virtual GPU device (PCI config space, BAR shadows, MSI-X), GSP boot emulation, GSP-RM message-queue/RPC emulation, memory model (GPU-VA to guest-PA discovery) and the semaphore-completion service that advances guest UVM progress. userspace/ libiov.so management API and examples. tools/ guest diagnostics, firmware analysis wrappers, RM probes. scripts/ stack manager, VM harness, build/load/test automation. config/ hardware/version profiles (the portability surface). docs/ documentation tree - start at docs/README.md. wiki/ long-form firmware and protocol deep dives. Status: initialization works end to end for a stock 570.144 Linux guest on Turing (TU104): driver probe, nvidia-smi, the full GSP-RM control battery, object creation and the early CUDA/UVM start-up path. GPU work forwarding - the step that makes CUDA kernels execute on real hardware - is the active work item; see docs/04-implementation/01-known-knowns-and-unknowns.md. License: BSD-3-Clause for the project; GPL-2.0 for kernel modules that link GPL-only kernel interfaces. See LICENSE and docs/09-reference/legal-and-licensing.md. --- legacy-driver-guest/README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 legacy-driver-guest/README.md (limited to 'legacy-driver-guest/README.md') diff --git a/legacy-driver-guest/README.md b/legacy-driver-guest/README.md new file mode 100644 index 0000000..309613a --- /dev/null +++ b/legacy-driver-guest/README.md @@ -0,0 +1,21 @@ +# legacy-driver-guest — historical guest-side driver (NOT BUILT) + +This directory preserves the **old guest-side vGPU driver** (`gsp-vgpu.ko`) +from the pre-refactor architecture, where GSP RPC handling lived in a kernel +module *inside the guest*. + +It is kept for reference only: + +- The current architecture is **host-only GSP emulation** — the guest runs + the stock, unmodified `nvidia.ko`, and there is no Open-IOV code in the + guest. See `docs/GSP_EMULATION_ARCHITECTURE.md`. +- Nothing here is part of any build target (the top-level Makefile no longer + references it). +- `kernel-tests/` holds the old test modules written against this driver's + internal API (`gsp_core.h`); they are superseded by + `kernel/tests/gsp_emulation_test.c`, which tests the host-side emulation + engine through `gsp_emu_process_rpc()`. + +Do not add new code here. If you need behavior that only exists in this tree +(e.g. WPR eventfd work, migration WPR state), port it into the host-side +`kernel/` modules rather than reviving the guest driver. -- cgit v1.2.3