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)