replace readme

This commit is contained in:
Lily Tsuru 2024-09-29 23:42:43 -04:00
parent 89d0c5e0ab
commit 0a9ac0721f

View file

@ -1,32 +1,17 @@
# Nvidia vGPU-Merged Packages for Arch Linux # `nvidia-merged`
Use Nvidia vGPU _and_ GeForce functions of consumer-grade NVIDIA GPUs.
This repository contains scripts for building all components of the "merged" driver package into drop-in replacements for the Arch Linux NVIDIA packages. It adds the following additional functions by means of scripts/drop-ins: This is NVIDIA vGPU R16 horribly hacked to build and work on up to Linux 6.11.
- Wrapper for `nvidia-smi` to support recognizing consumer GPUs as vGPU-capable
- Dependency re-ordering to ensure `libvirtd`, if installed, will start _after_ the NVIDIA vGPU services.
Compatible Linux Versions: # Building
- Various 5.11 or older releases
- 5.12
- 5.14 except for some of the earlier 5.14 releases
- 5.15
## Important `makepkg` will build with linux 6.1x patches.
These packages are not guaranteed to work out of the box (or at all), so use it at your own risk. Backups should be taken before attempting to replace stock NVIDIA drivers on any system.
## Installation To disable them, use `_use_new_patches="false" makepkg`. This is useful if you're not using a upstream kernel
1. Build and install desired packages
2. Edit `/etc/vgpu_unlock/profile_override.toml` and set desired overrides.
3. Enable `nvidia-vgpu-mgr.service` and `nvidia-vgpud.service`
4. Reboot.
It is recommended to at least install `nvidia-merged` and `nvidia-merged-settings`, which will include the required services/kernel module sources by dependency. **NOTICE**: the vGPU VFIO module needs CONFIG_IOMMUFD=n to function properly. No Arch kernels are built with this config option set correctly, so you will have to build your own kernel.
## Credits # Thanks
This project would not be possible without all those who came before me that wrote the software and figured out how to implement it:
- [DualCoder - vgpu_unlock](https://github.com/DualCoder/vgpu_unlock) - Erin-allison originally created the PKGBUILD I based this on.
- [rupansh - twelve.patch](https://github.com/rupansh/vgpu_unlock_5.12) - Snowman for vGPU-Unlock-Patcher
- [HiFiPhile - cvgpu.c](https://gist.github.com/HiFiPhile/b3267ce1e93f15642ce3943db6e60776/) - vgpu-unlock_rs
- [Krutav Shah - vGPU_Unlock Wiki](https://docs.google.com/document/d/1pzrWJ9h-zANCtyqRgS7Vzla0Y8Ea2-5z2HEi4X75d2Q)
- [tuh8888 - libvirt_win10_vm](https://github.com/tuh8888/libvirt_win10_vm)
- [mbilker - vgpu_unlock-rs](https://github.com/mbilker/vgpu_unlock-rs)