You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
43 lines
2.5 KiB
Markdown
43 lines
2.5 KiB
Markdown
# VFIO-Tools
|
|
A collection of tools and scripts that aim to make PCI passthrough a little easier.
|
|
For more in-depth guides on how to use these tools, as well as PCI passthrough related news, benchmarks and tutorials, visit us on https://passthroughpo.st
|
|
|
|
## libvirt_hooks
|
|
|
|
### QEMU hook helper
|
|
This contains a hook-helper for libvirt which allows easier per-VM hooks.
|
|
Simply drop the `qemu` file in `$SYSCONFDIR/libvirt/hooks/` (usually `/etc/libvirt/hooks`) and you're ready to add hooks.
|
|
You can have a virtually limitless number of hook scripts per VM and per hook call, just keep in mind that a failed hook will prevent a VM from starting.
|
|
The way to add hooks is as follows:
|
|
- Create a file in a path matching this structure:
|
|
```
|
|
$SYSCONFDIR/libvirt/hooks/qemu.d/vm_name/hook_name/state_name/yourhook.conf
|
|
```
|
|
- You can put anything you like in the hook, as long as you make sure you start your hook with a hashbang (i.e. `#!/bin/bash`).
|
|
- When you're done setting up your hook, run `chmod +x` on your hook file to make it executable.
|
|
- If you've added the `qemu` hook helper file for the first time, you need to restart libvirt in order for it to be detected.
|
|
|
|
### switch_displays.sh
|
|
This hook allows you to automatically switch your monitor input to your VM's display.
|
|
To achieve this you need to have `ddcutil` installed and working and you need a DDC/CI capable monitor.
|
|
For a more detailed explanation and write-up, check out https://passthroughpo.st
|
|
|
|
## vfioselect
|
|
|
|
### vfio-pci helper
|
|
Makes assigning PCI devices to vfio-pci a bit easier, can generate modprobe rules, or bind a device to vfio-pci without needing to reboot. Requires dialog.
|
|
```
|
|
Usage: vfioselect [<arguments>]
|
|
-t,--tmpfile <path> Specify path to temporary file
|
|
-g,--genfile <path> Specify path to modprobe rule
|
|
-o,--online Attempt to bind/unbind without the need to reboot
|
|
-h,--help Display this help dialogue
|
|
```
|
|
- vfioselect parses the rules that you define, if you have a rule already made, it is best to rename it to the default for vfioselect (vfioselect.conf), but a config file can be specified via `-g /path/to/config.conf`
|
|
- If binding with a GPU shared between host and guest, it might be a good idea to use a qemu hook to switch input after the machine boots.
|
|
|
|
|
|
|
|
***We enjoy creating these tools for the community and everything we make is completely free and open source -- but developing them takes a lot of time and effort. Consider [becoming a Patron](https://www.patreon.com/PassthroughPost) to keep projects like these alive.***
|
|
|