diff options
Diffstat (limited to 'tools/site/pages/Main-Page.wiki')
| -rw-r--r-- | tools/site/pages/Main-Page.wiki | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/tools/site/pages/Main-Page.wiki b/tools/site/pages/Main-Page.wiki new file mode 100644 index 0000000..fb08f81 --- /dev/null +++ b/tools/site/pages/Main-Page.wiki @@ -0,0 +1,78 @@ +{{About message}} + +__NOTOC__ +<div style="border:1px solid #c8ccd1; background:#f8f9fa; padding:0.9em 1.2em; margin-bottom:1em;"> +'''Open-IOV''' is an open-source virtualization layer for NVIDIA GPUs: it runs '''stock, unmodified NVIDIA drivers inside virtual machines''' — Linux and Windows — with CUDA on hardware you own, '''without proprietary vGPU licenses''', without patching the guest driver, the host driver, the hypervisor or the firmware. + +'''''Emulate the interface. Pass through the work. Never patch anyone.''''' + +The only new component is one host kernel module (<code>vgsp.ko</code>), which implements the interface the guest driver expects to talk to — the GPU System Processor and its resource-manager firmware — and arranges for the guest's work to run on real GPU hardware. + +'''[[Open-IOV:About|About Open-IOV]]''' · '''[[Community|Community]]''' · '''[[Documentation|Documentation]]''' +</div> + +== Start here == +* '''[[Project Status]]''' — the honest, dated state of the project. +* '''[[Install and First Run]]''' — fresh host to a stock guest driver in about half an hour. +* '''[[System Overview]]''' — how Open-IOV works, in one page. +* '''[[Documentation]]''' — the full index of this wiki. +* '''[[FAQ]]''' — the questions we get asked most. + +== Project status (2026-10-12) == +{| class="wikitable" +! Area !! State +|- +| Emulated vGPU device (PCI, BARs, MSI-X, VFIO mdev) || Working +|- +| GSP boot emulation and GSP-RM message queues / RPC || Working +|- +| Stock guest driver probe, nvidia-smi (TU104) || Working +|- +| CUDA userspace init and the driver-API smoke (ALL OK, 64-byte payload round-trips) || Working +|- +| Guest CUDA kernel execution on real hardware || In progress — a forwarded launch reaches the engine queue; engine execution is the frontier +|- +| OpenGL / Vulkan, Windows guests, multi-tenancy, migration, performance || Not yet +|} + +The full story, with evidence and the current wall: [[Project Status]] and [[The Execution Frontier]]. + +== Deep dives == +* [[System Overview]] — the architecture before any subsystem +* [[GSP and GSP-RM]] — the firmware interface we emulate +* [[The vGSP Execution Plane (vEP)]] — how guest work becomes execution and completion +* [[The Host Module (vgsp.ko)]] — the module internals +* [[The Guest Stack and CUDASW]] — what runs unmodified in the guest +* [[CUDA Userspace Driver]] — the <code>libcuda.so</code> analysis +* [[Introduction to GMMU]] — GPU address translation from first principles +* [[UVM in the Guest]] — unified memory as a correctness oracle +* [[Physical GPU Backend and Guest Wiring]] — how work reaches real hardware +* [[The Execution Frontier]] — the leading edge, evidence-led +* [[Guest Driver Lifecycle: A Field Guide]] — boot to CUDA with real IDs and log signatures + +== Firmware interoperability == +* [[GSP 570.144W Firmware Analysis]] +* [[Address Reference]] +* [[RPC Message Format]] · [[BAR Emulation Specification]] · [[WPR Management]] · [[Migration Protocol]] · [[GSP RPC Emulation]] (historical, superseded) +* [[risc-v-gsp-rm-debugger]] — the firmware runtime workbench + +== Project and ecosystem == +* [[Hardware and Software Matrix]] — supported combinations, honestly labelled +* [[HAAEEP and Collaboration]] — the agent-edge use case and how to work with us +* [[FAQ]] · [[Glossary]] + +== Community == +* Source and issues: [https://git.vgpu.io/open-iov git.vgpu.io/open-iov] +* Chat: [https://discord.gg/Rb9K9DYxKK Open-IOV Discord] + +== About Open-IOV == +Open-IOV runs unmodified NVIDIA driver stacks inside virtual machines with GPU compute on hardware you own — no proprietary vGPU license, and no patches to the guest driver, the host driver, the hypervisor or the firmware. The project adds one host kernel module (<code>vgsp.ko</code>) that implements the interface the guest driver expects to talk to — the GPU System Processor and its resource-manager firmware — and arranges for the guest's work to run on real GPU hardware. + +* '''Mission:''' make NVIDIA GPUs fully virtualizable, by anyone, for any hypervisor, without modifying NVIDIA software, firmware or hardware. +* '''Principles:''' no patches anywhere; honest status carried with dated evidence; an independent, self-contained IP block; durability by owning the interface rather than a snapshot of it. +* '''Licensing:''' all documentation on this site is [https://creativecommons.org/licenses/by/4.0/ CC-BY-4.0]; the project's code is BSD-3-Clause (GPL-2.0 for the kernel modules); NVIDIA software and firmware are used unmodified and are not redistributed. + +'''[[Open-IOV:About|Read more about Open-IOV →]]''' + +== About this wiki == +This wiki previously hosted documentation from the earlier project era (2021–2023). Those pages are retained for reference under [[Documentation|History]]; current documentation starts at [[Documentation]]. |