AUTOPKGTEST-VIRT-QEMU+ROCM(1)

πŸ“¦
version 0.9.8ubuntu2 Β· 3 versions
, in ubuntu stonking

πŸ’– AUTOPKGTEST-VIRT-QEMU+ROCM(1) πŸ’–

okay bestie, gather round, because this is the manual page for autopkgtest-virt-qemu+rocm 🫢 (that's the whole name, she's long, she's iconic, we love her).


✨ NAME ✨

autopkgtest-virt-qemu+rocm β€” literally just autopkgtest-virt-qemu+rocm, no notes πŸ’…


🌸 DESCRIPTION 🌸

sooo this is the autopkgtest QEMU backend but with AMD GPU pass-through support. main character energy fr ✨

It's a thin wrapper around autopkgtest-virt-qemu(1). Like, it's not doing a whole new thing, it's just her, but sparklier πŸ¦‹

By default, every AMD GPU assigned to vfio-pci gets passed through. You can override that with --gpu, and you can pass that flag multiple times. [NOTE: multi-GPU is untested as of yet] β€” so like, go off, but nobody's verified that path yet, okay? πŸ™ˆ

By default the VM gets 75% of the host's cores and 75% of the host's memory. Generous queen, but not that generous πŸ‘‘

Every other option on the command line gets passed straight on to autopkgtest-virt-qemu, so please go read its man page for the deets. For example, use --ram-size or --cpus if you wanna deviate from that 75% default we just talked about πŸ’–

This thing will always boot an image in EFI mode. It will also always request a clean poweroff after a test (--timeout-poweroff), instead of the default behaviour of sending SIGTERM. no rude exits here, we knock politely 😌

It also assumes the invoking user has all the necessary permissions required to effectively and efficiently operate the VM β€” most notably, access to /dev/kvm. When in doubt, try running the script as root. πŸ”₯

🌈 Synopsis:

virt/autopkgtest-virt-qemu+rocm -h

virt/autopkgtest-virt-qemu+rocm autopkgtest [...] -- qemu+rocm
[--gpu GPU] [options] image [ro-image ...]

πŸ’… OPTIONS πŸ’…

  • --gpu GPU β€” the PCI slot ID of the GPU you want to pass through (eg: 09:00.0). Can used multiple times. πŸŽ€

⭐ EXAMPLES ⭐

# Create an image first

$ sudo rocm-qemu-create unstable.img
$ sudo chown $USER: unstable.img

# Run autopkgtests for src:rocrand, using packages from the
Archive

$ autopkgtest -B rocrand -- qemu+rocm unstable.img

# Like above, but limit to the GPU in slot 09:00.0

$ autopkgtest -B rocrand -- qemu+rocm --gpu 09:00.0 unstable.img

and that's the whole page, bestie, you ate it πŸ“ this one ships from debian, dated July 2026 β€” mwah, periodt πŸ’œπŸ§š

πŸ“¦ where this page comes from