.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ROCM-QEMU-CREATE "8" "March 2025" "debian" "System Administration Utilities"
.SH NAME
rocm-qemu-create \- rocm-qemu-create
.SH DESCRIPTION
Create a QEMU VM for suitable for running ROCm package autopkgtests.
.PP
IMAGE, if not specified, defaults to RELEASE.img.
.PP
This script will build an EFI\-bootable image IMAGE, with packages
firmware\-amd\-graphics and openssh\-server preinstalled, and (optionally) other
minor customizations.
.PP
The image will have a regular (non\-system) user 'user', who will be in all
the necessary system groups.
.PP
You will be able to share a host directory with the guest.
.SS "Synopsis:"
.IP
bin/rocm\-qemu\-create \fB\-h\fR
.IP
bin/rocm\-qemu\-create [\-a AKFILE] [\-m MIRROR] [\-r RELEASE] [IMAGE]
.SH OPTIONS
.TP
\fB\-h\fR
Show this help
.TP
\fB\-a\fR AKFILE
File to copy to /root/.ssh/authorized_keys and to
/home/rocm/.ssh/authorized_keys in the guest.
.TP
\fB\-m\fR MIRROR
Download packages from here. This will be also used within
the image. Ideally, this points to an APT cache on the host
machine, such as apt\-cacher\-ng or approx.
.TP
\fB\-r\fR RELEASE
Release (default: 'unstable')
If RELEASE is 'experimental', APT sources for both 'unstable'
and 'experimental' will be added to the image.
If RELEASE contains a dash, APT sources for the "basename"
will be added, e.g.: 'bookworm\-backports' will include
sources for 'bookworm' and 'bookworm\-backports'.
.SH EXAMPLES
.IP
# Configure the system for GPU pass\-through
.IP
\f(CW$ rocm-qemu-setup -u <user>\fR
.IP
# Creates unstable.img based on unstable
.IP
\f(CW$ sudo bin/rocm-qemu-create\fR
.IP
# Same image as above, but named unstable\-autopkgtest\-amd64.img
.IP
\f(CW$ sudo bin/rocm-qemu-create unstable-autopkgtest-amd64.img\fR
.IP
# Create unstable.img using the mirror at 10.1.2.3:9999, which ideally
# is a local APT cache
.IP
\f(CW$ sudo bin/rocm-qemu-create -m http://10.1.2.3:9999/debian\fR
.IP
# Creates bookworm.img
.IP
\f(CW$ sudo bin/rocm-qemu-create -r bookworm\fR
.IP
# Copies this file to {/root,/home/rocm}/.ssh/authorized_keys
.IP
\f(CW$ sudo bin/rocm-qemu-create -a ~/.ssh/id_rsa.pub\fR