NAME

       autopkgtest-build-qemu  -  Create autopkgtest virtual machine images for autopkgtest-virt-
       qemu

SYNOPSIS

       autopkgtest-build-qemu RELEASE IMAGE [MIRROR] [ARCHITECTURE] [SCRIPT] [SIZE]

DESCRIPTION

       autopkgtest-build-qemu creates virtual machine images suitable for use with  autopkgtest's
       QEMU runner autopkgtest-virt-qemu(1).

       Under the hood, it uses vmdb2(1) to create the images.

       The  MIRROR  parameter can be used to control which distrition to install.  It defaults to
       http://deb.debian.org/debian (i.e. Debian), but you  can  pass  a  mirror  of  any  Debian
       derivative.

       The  ARCHITECTURE  parameter  controls  the  architecture  the  virtual  machine image. If
       omitted, the host architecture is assumed.

       The SCRIPT parameter 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 SIZE parameter specifies the image size for the virtual machine, and defaults to 25G.

       It defaults to the native architecture, but you can specify  a  different  one  as  fourth
       parameter.

       The  path  to  a  script  to be executed inside the virtual machine root filesystem can be
       passed as the fifth parameter. 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.

       Note that you need to call this as root.

ENVIRONMENT

       If the $AUTOPKGTEST_KEEP_APT_SOURCES environment variable is set  to  a  non-empty  value,
       autopkgtest-build-qemu   will   keep   whatever   /etc/apt/sources.list   was  created  by
       debootstrap.

       Otherwise, if the $AUTOPKGTEST_APT_SOURCES_FILE environment variable is set to a non-empty
       value,   for   example  AUTOPKGTEST_APT_SOURCES_FILE=/home/me/mydistro/sources.list,  then
       autopkgtest-build-qemu will read that file (on the host system) and  use  it  to  populate
       /etc/apt/sources.list   in   the  virtual  machine;  or  if  the  $AUTOPKGTEST_APT_SOURCES
       environment    variable    is    set    to    a    non-empty    value,     for     example
       AUTOPKGTEST_APT_SOURCES=$(cat /home/me/mydistro/sources.list), autopkgtest-build-qemu will
       write it directly into /etc/apt/sources.list in the virtual machine.

       You can specify an apt proxy to use in the virtual machine in  the  $AUTOPKGTEST_APT_PROXY
       environment variable. If you have an apt proxy configured on the host, the virtual machine
       will automatically use this, otherwise there is no default.

EXAMPLES

       # autopkgtest-build-qemu unstable /path/to/debian-unstable.img

       $ sudo autopkgtest-build-qemu stable /path/to/debian-stable-i386.img i386

       $       sudo        autopkgtest-build-qemu        bionic        /path/to/ubuntu-bionic.img
       http://archive.ubuntu.com/ubuntu

SEE ALSO

       autopkgtest-virt-qemu(1), vmdb2(1), autopkgtest(1), /usr/share/doc/autopkgtest/.

AUTHORS AND COPYRIGHT

       autopkgtest-build-qemu was written by Antonio Terceiro <terceirio@debian.org>

       This  manpage  is  part  of  autopkgtest,  a  tool  for  testing  Debian  binary packages.
       autopkgtest is Copyright (C) 2006-2018 Canonical Ltd and others.

       See /usr/share/doc/autopkgtest/CREDITS for the  list  of  contributors  and  full  copying
       conditions.