Zagitta/gpu-unlock

选用指南

AI 根据 README 整理 · 2026/10/23 10:26:26

使用方式

通过内核命令行参数启用，支持指定PCI地址或全部GA102/GA104显卡。

查看 README 依据

The module does nothing unless the kernel command line opts in: ``` gpu_unlock.targets=all # every unbound GA102/GA104 card gpu_unlock.targets=0000:21:00.0 # only these cards gpu_unlock.targets=0000:21:00.0,0000:22:00.0 # comma-separated ``` Addresses are full PCI names as `lspci -D` prints them (hex digits in either case), independent of GPU numbering and display role. An entry that is not a GA102/GA104 card, including `all` mixed with addresses, is logged and ignored. The cards are unlocked concurrently, about a second in all however many

部署要求

需要Linux内核模块构建环境，支持Arch、Debian/Ubuntu、Fedora/RHEL等发行版，需要内核命令行配置。

查看 README 依据

make install ``` Then append `gpu_unlock.targets=all` to your kernel command line, keeping existing options: - **GRUB (Debian/Ubuntu/Mint):** add it inside `GRUB_CMDLINE_LINUX_DEFAULT` in `/etc/default/grub`, then run `sudo update-grub`. - **GRUB (Arch/CachyOS):** same edit, then run `sudo grub-mkconfig -o /boot/grub/grub.cfg`. - **Fedora/RHEL:** run `sudo grubby --update-kernel=ALL --args="gpu_unlock.targets=all"`. - **systemd-boot:** append it to the `options` line in your boot entry (`bootctl status` shows its location).

make install # detect the distribution and select an installer make install-arch # makepkg -sif make install-deb # apt-get build-dep, dpkg-buildpackage, apt-get install make install-rpm # dnf builddep, rpmbuild, dnf install ``` `make install` uses `/etc/os-release` (`ID`, then `ID_LIKE`) to detect Arch, Debian/Ubuntu, or Fedora/RHEL/CentOS families. The RPM installer requires DNF. For other distributions, select a compatible explicit target above. `make arch`, `make deb` and `make rpm` only build. Debian and RPM packages go

已知限制

仅支持GA102和GA104显卡，且必须在NVIDIA驱动绑定前加载，否则无效。

查看 README 依据

# GPU unlock 1.0.0 This Linux kernel module combines the CMP unlocker's V67/PLM technique with the pre-driver timing of the UEFI approach. It runs the unlock, writes the speed selectors (SS0 `0x88888888`, which selects the full BF16 rate, and the 4-bit SS1 `0x8` IMLA4) and performs FLR before the unmodified NVIDIA driver binds the card. It is neither a UEFI application nor a patched NVIDIA driver. The benefit of this early kmod driver is that it does not require manual patching each time nvidia releases a new driver version.

later anyway. Its screen is blank from that reset until `nvidia-drm` takes over. Loading the module by hand after boot does nothing to a card that `nvidia` has bound. Check the result with: ```sh journalctl -k -b | grep gpu_unlock lspci -nnk -s 0000:21:00.0 ``` To stop unlocking, remove `gpu_unlock.targets=` from the kernel command line; for a one-off boot, delete it in the bootloader's edit screen. Removing the packages also removes the module and the initramfs drop-ins. If the firmware on a card never stops, the module logs it and keeps the DMA