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.

1 files changed, 44 insertions, 0 deletions

diff --git a/legacy-driver-guest/Makefile b/legacy-driver-guest/Makefile
new file mode 100644
index 0000000..4675cbf
--- /dev/null
+++ b/legacy-driver-guest/Makefile
@@ -0,0 +1,44 @@
+# GSP vGPU-IO Driver Makefile
+
+obj-m += gsp-vgpu.o
+
+gsp-vgpu-y := \
+    core/gsp_core.o \
+    rpc/gsp_rpc.o \
+    vf/gsp_vf.o \
+    bar/gsp_bar.o \
+    wpr/gsp_wpr.o \
+    migration/gsp_migration.o \
+    debugfs/gsp_debugfs.o
+
+ccflags-y += -I$(src)/include
+ccflags-y += -I$(src)/../kernel/include
+
+# Build against the kernel source
+KDIR ?= /lib/modules/$(shell uname -r)/build
+
+all:
+	$(MAKE) -C $(KDIR) M=$(PWD) modules
+
+clean:
+	$(MAKE) -C $(KDIR) M=$(PWD) clean
+
+install:
+	$(MAKE) -C $(KDIR) M=$(PWD) modules_install
+
+load: all
+	sudo insmod gsp-vgpu.ko firmware_name=gsp-570.144.fwimage.bin
+
+unload:
+	sudo rmmod gsp-vgpu
+
+test: all load
+	@echo "Driver loaded, checking status..."
+	sleep 2
+	dmesg -T | tail -20
+	@echo "Checking debugfs..."
+	ls -la /sys/kernel/debug/gsp-vgpu/ 2>/dev/null || echo "Debugfs not available"
+	@echo "Checking device nodes..."
+	ls -la /dev/gsp-vgpu* 2>/dev/null || echo "No device nodes"
+
+.PHONY: all clean install load unload test
\ No newline at end of file