Skip to content

Commit efe0e33

Browse files
LinuxDev9002claude
andcommitted
Emphasize insmod-only loading in README, never global install
Co-Authored-By: Claude Opus 4.6 <[email protected]>
1 parent 6769903 commit efe0e33

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

README.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -91,9 +91,9 @@ kernel-open/nvidia-drm.ko
9191
kernel-open/nvidia-uvm.ko # Contains eBPF hooks
9292
```
9393

94-
### 3. Load Custom Kernel Module
94+
### 3. Load Custom Kernel Module (insmod only)
9595

96-
Replace the system NVIDIA modules with the custom-built ones (temporary, reverts on reboot):
96+
> **IMPORTANT**: Only use `insmod` for temporary loading. **NEVER run `make modules_install`** or copy `.ko` files to `/lib/modules/`. The custom modules are loaded into the running kernel only and automatically revert to the system NVIDIA driver on reboot. This ensures system stability — if anything goes wrong, a simple reboot restores the original driver.
9797
9898
```bash
9999
# Unload system modules
@@ -102,7 +102,7 @@ sudo systemctl stop gdm3 2>/dev/null || true
102102
sleep 2
103103
sudo rmmod nvidia_uvm nvidia_drm nvidia_modeset nvidia 2>/dev/null || true
104104

105-
# Load custom modules (in dependency order)
105+
# Load custom modules via insmod (in dependency order)
106106
sudo insmod kernel-module/nvidia-module/kernel-open/nvidia.ko
107107
sudo insmod kernel-module/nvidia-module/kernel-open/nvidia-modeset.ko
108108
sudo insmod kernel-module/nvidia-module/kernel-open/nvidia-drm.ko
@@ -115,7 +115,13 @@ sudo systemctl start gdm3 2>/dev/null || true
115115
lsmod | grep nvidia
116116
```
117117

118-
For permanent installation and troubleshooting, see [docs/driver_docs/MODULE_LOAD_UNLOAD_GUIDE.md](docs/driver_docs/MODULE_LOAD_UNLOAD_GUIDE.md).
118+
To revert to system modules at any time (without reboot):
119+
```bash
120+
sudo rmmod nvidia_uvm nvidia_drm nvidia_modeset nvidia
121+
sudo modprobe nvidia && sudo modprobe nvidia_uvm
122+
```
123+
124+
For detailed troubleshooting, see [docs/driver_docs/MODULE_LOAD_UNLOAD_GUIDE.md](docs/driver_docs/MODULE_LOAD_UNLOAD_GUIDE.md).
119125

120126
### 4. Load an eBPF Policy
121127

0 commit comments

Comments
 (0)