summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md28
1 files changed, 24 insertions, 4 deletions
diff --git a/README.md b/README.md
index ab699d9..2f89f58 100644
--- a/README.md
+++ b/README.md
@@ -48,20 +48,40 @@ cd open-iov
make # Builds kernel module, userspace lib, examples
```
+### Build NVIDIA OpenRM with vGPU VFIO Symbols
+
+**Critical**: The NVIDIA OpenRM `nvidia.ko` must be built with `KBUILD_EXTRA_SYMBOLS` pointing to `open-iov-vfio.ko`'s `Module.symvers` to resolve the vGPU VFIO interface symbols (`nvidia_vgpu_vfio_probe`, `nvidia_vgpu_vfio_remove`, etc.).
+
+```bash
+# Build Open-IOV kernel module first (generates Module.symvers)
+cd open-iov
+make kernel
+
+# Build NVIDIA OpenRM with vGPU VFIO symbols (use helper script)
+./scripts/build_nvidia_openrm.sh
+
+# Or manually:
+cd nvidia-open-gpu-kernel-modules/kernel-open
+KBUILD_EXTRA_SYMBOLS=$OPEN_IOV_ROOT/kernel/Module.symvers make -j$(nproc) modules
+```
+
### Install Kernel Module
```bash
# Copy firmware
-sudo cp firmware/570-GSP/gsp-570.144.fwimage.bin /lib/firmware/
+sudo cp firmware/57X-GSP/570.144/gsp-570.144.fwimage.bin /lib/firmware/
+
+# Load NVIDIA OpenRM host driver (exports vGPU VFIO symbols)
+sudo insmod nvidia-open-gpu-kernel-modules/kernel-open/nvidia.ko
-# Load kernel module (emulation mode ON by default, auto-detects GSP capabilities)
+# Load Open-IOV host VFIO driver (with GSP emulation engine)
sudo insmod kernel/open-iov-vfio.ko
-# Or load guest driver with emulation
+# Or load guest driver with emulation (legacy path)
sudo insmod driver/gsp-vgpu.ko firmware_name=gsp-570.144.fwimage.bin
# Verify
-dmesg -T | grep -E "gsp-vgpu|open-iov"
+dmesg -T | grep -E "gsp-vgpu|open-iov|nvidia"
ls -la /dev/gsp-vgpu /dev/open-iov
```