NAME

       mmdebstrap-autopkgtest-build-qemu - autopkgtest-build-qemu without vmdb2 but mmdebstrap and EFI boot

SYNOPSIS

       mmdebstrap-autopkgtest-build-qemu [OPTIONS] --boot=efi RELEASE IMAGE

DESCRIPTION

       mmdebstrap-autopkgtest-build-qemu is a mostly compatible drop-in replacement for
       autopkgtest-build-qemu(1) with two main differences: Firstly, it uses mmdebstrap(1) instead of vmdb2(1)
       and thus is able to create QEMU disk images without requiring superuser privileges.  Secondly, it uses
       systemd-boot(7) and thus only supports booting via EFI. For architectures for which
       autopkgtest-virt-qemu(1) does not default to EFI booting you must pass --boot=efi when invoking the
       autopkgtest virt backend.

POSITIONAL PARAMETERS

       RELEASE The release to download from the MIRROR.  This parameter is required.

       IMAGE   The file to write, in raw format. This parameter is required.

OPTIONS

       --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.

       --architecture=ARCHITECTURE
               Set the architecture for the virtual machine image, specified  as  a  dpkg(1)  architecture.   If
               omitted, the host architecture is assumed.

               --arch=ARCH is an alias for this option.

       --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.

               The script must be a POSIX shell script, and should not depend on  bash-specific  features.  This
               script will be executed inside a chroot(1) call in the virtual machine root filesystem.

       --size=SIZE
               Specifies the image size for the virtual machine, defaulting to 25G.

       --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.

       --boot=efi, --efi
               Select  the  way  the  generated  image  will  expect  to be booted. Unless you explicitly select
               --boot=efi, operation will fail.

       --keyring=KEYRING
               Passes an additional --keyring parameter to mmdebstrap.

EXAMPLES

       Make sure, that /path/to/debian-unstable.img 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.

           $ 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

       Make sure to add --boot=efi to both the mmdebstrap-autopkgtest-build-qemu as  well  as  the  autopkgtest-
       virt-qemu invocation.

SEE ALSO

       autopkgtest-build-qemu(1), autopkgtest-virt-qemu(1), mmdebstrap(1), autopkgtest(1)

perl v5.38.2                                       2024-02-26               MMDEBSTRAP-AUTOPKGTEST-BUILD-QEMU(1)