.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "MMDEBSTRAP-AUTOPKGTEST-BUILD-QEMU 1"
.TH MMDEBSTRAP-AUTOPKGTEST-BUILD-QEMU 1 2024-05-15 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
mmdebstrap\-autopkgtest\-build\-qemu \- autopkgtest\-build\-qemu without vmdb2 but mmdebstrap and EFI boot
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBmmdebstrap-autopkgtest-build-qemu\fR [\fIOPTIONS\fR] \fB\-\-boot\fR=\fBefi\fR \fIRELEASE\fR \fIIMAGE\fR
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBmmdebstrap-autopkgtest-build-qemu\fR is a mostly compatible drop-in replacement
for \fBautopkgtest\-build\-qemu\fR\|(1) with two main differences: Firstly, it uses
\&\fBmmdebstrap\fR\|(1) instead of \fBvmdb2\fR\|(1) and thus is able to create QEMU disk
images without requiring superuser privileges.  Secondly, it uses
\&\fBsystemd\-boot\fR\|(7) and thus only supports booting via EFI. For architectures
for which \fBautopkgtest\-virt\-qemu\fR\|(1) does not default to EFI booting you must
pass \fB\-\-boot=efi\fR when invoking the autopkgtest virt backend.
.SH "POSITIONAL PARAMETERS"
.IX Header "POSITIONAL PARAMETERS"
.IP \fIRELEASE\fR 8
.IX Item "RELEASE"
The release to download from the \fIMIRROR\fR.  This parameter is required.
.IP \fIIMAGE\fR 8
.IX Item "IMAGE"
The file to write, in raw format. This parameter is required.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-\-mirror\fR=\fIMIRROR\fR 8
.IX Item "--mirror=MIRROR"
Specify  which  distribution  to install.  It defaults to
http://deb.debian.org/debian (i.e. Debian), but you can pass a mirror of any
Debian derivative.
.IP \fB\-\-architecture\fR=\fIARCHITECTURE\fR 8
.IX Item "--architecture=ARCHITECTURE"
Set the architecture for the virtual machine image, specified as a \fBdpkg\fR\|(1)
architecture.  If  omitted, the host architecture is assumed.
.Sp
\&\fB\-\-arch\fR=\fIARCH\fR is an alias for this option.
.IP \fB\-\-script\fR=\fISCRIPT\fR 8
.IX Item "--script=SCRIPT"
Specifies a user script that will be called with the root filesystem of the
image as its first parameter. This script can them make any necesssary
modifications to the root filesystem.
.Sp
The script must be a POSIX shell script, and should not depend on bash-specific
features. This  script will be executed inside a \fBchroot\fR\|(1) call in the
virtual machine root filesystem.
.IP \fB\-\-size\fR=\fISIZE\fR 8
.IX Item "--size=SIZE"
Specifies the image size for the virtual machine, defaulting to 25G.
.IP \fB\-\-apt\-proxy\fR=\fIPROXY\fR 8
.IX Item "--apt-proxy=PROXY"
Specify  an  apt proxy to use in the virtual machine.  By default, if you have
an apt proxy configured on the host, the virtual machine will automatically use
this, otherwise there is no default.
.IP "\fB\-\-boot\fR=\fBefi\fR, \fB\-\-efi\fR" 8
.IX Item "--boot=efi, --efi"
Select the way the generated image will expect to be booted. Unless you
explicitly select \-\-boot=efi, operation will fail.
.IP \fB\-\-keyring\fR=\fIKEYRING\fR 8
.IX Item "--keyring=KEYRING"
Passes an additional \fB\-\-keyring\fR parameter to \fBmmdebstrap\fR.
.SH EXAMPLES
.IX Header "EXAMPLES"
Make sure, that \fI/path/to/debian\-unstable.img\fR is a path that the unshared
user has access to. This can be done by ensuring world-execute permissions on
all path components or by creating the image in a world-readable directory like
/tmp before copying it into its final location.
.PP
.Vb 3
\&    $ mmdebstrap\-autopkgtest\-build\-qemu \-\-boot=efi \-\-arch=amd64 unstable /path/to/debian\-unstable.img
\&    [...]
\&    $ autopkgtest mypackage \-\- qemu \-\-boot=efi \-\-dpkg\-architecture=amd64 /path/to/debian\-unstable.img
.Ve
.PP
Make sure to add \fB\-\-boot=efi\fR to both the \fBmmdebstrap-autopkgtest-build-qemu\fR
as well as the \fBautopkgtest-virt-qemu\fR invocation.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBautopkgtest\-build\-qemu\fR\|(1), \fBautopkgtest\-virt\-qemu\fR\|(1), \fBmmdebstrap\fR\|(1), \fBautopkgtest\fR\|(1)