NAME

       sbuild-qemu - sbuild using QEMU images

SYNOPSIS

       sbuild-qemu [-h] [--arch=ARCH] [-d=DIST] [--image=IMAGE] [--autopkgtest-debug] [--ram=MiB]
       [--cpus=CPUs] [--overlay-dir=OVERLAY_DIR] [--noexec]

       Build   Debian   packages   with   sbuild   using   QEMU   images,   by   using   sbuild's
       --chroot-mode=autopkgtest.

       All options other than the ones described below are passed on through to sbuild. The image
       will be started in snapshot mode, so the image is never changed.  Multiple  processes  can
       use the same image concurrently.

OPTIONS

       -h, --help
              Show this help message and exit.

       --arch=ARCH
              Architecture  to  use.  Default  is  the  host  architecture.  Currently  supported
              architectures are: amd64, i386.

       -d=DIST, --dist=DIST
              Distribution (for the .changes file). Default is unstable.

       --image=IMAGE
              VM image to use for building. If not specified, will look for  an  image  with  the
              name DIST-autopkgtest-ARCH.img. Will first look in the current directory, and if no
              such file exists there, then the directory $IMAGEDIR is tried. A suitable image can
              be created with sbuild-qemu-create(1).

       --autopkgtest-debug
              Enable debug output for the autopkgtest-virt-qemu(1) driver.

       --ram=MiB
              VM memory size in MB. Default: 2048

       --cpus=CPUs
              VM CPU count. Default: Number of physical cores on the host.

       --overlay-dir=OVERLAY_DIR
              Directory  for the temporary image overlay instead of autopkgtest's default of /tmp
              (or $TMPDIR).

       --noexec
              Don't actually do anything. Just print the sbuild(1) command string that  would  be
              executed, and then exit.

CONSIDERATIONS

       Using a fast temporary image overlay is key to faster build times. An overlay created on a
       tmpfs would be ideal, and can speed up I/O by an order of magnitude, compared  to  a  slow
       HDD. If /tmp or $TMPDIR are mountpoints for a tmpfs, then all should be fine by default.

       However,  tmpfs  filesystems are backed by memory and swap on the host, so a build needing
       substantial disk space in the VM may fail.  If  this  happens,  the  --overlay-dir  option
       should  be used to point to a host directory with more available disk space. Note that the
       base image itself must have been created with a suitable size, see the  --size  option  to
       sbuild-qemu-create(1).

LIMITATIONS

       Due  to  the  nature  of  sbuild's  --chroot-mode=autopkgtest,  not all sbuild options are
       supported  yet.  In  particular,  getting  an  interactive  shell,   for   example   using
       --build-failed-command is NOT possible.  However, there are other ways to access the build
       environment (see below).

VM ACCESS

       sbuild's --chroot-mode=autopkgtest uses autopkgtest-virt-qemu under the hood, so you  will
       find  an  SSH shell on port 10022 (or the first free port after that) if, and only if, the
       openssh-server package is installed in the VM.

       As a further consequence of this chroot mode, what is stated  in  autopkgtest-virt-qemu(1)
       generally also holds here.

EXAMPLES

       $ sbuild-qemu -d unstable -s --arch-all FOO.dsc

       This  will  build  the package FOO.dsc using unstable as the Distribution in the generated
       .changes file.

       Because   the   --image   option   was   not   specified,   an   image   with   the   name
       unstable-autopkgtest-amd64.img will be looked for first in the current directory, and then
       in $IMAGEDIR.

       The -s and --arch-all aren't known to sbuild-qemu, and are therefore  will  be  passed  on
       through to sbuild for it to use.

ENVIRONMENT

       $IMAGEDIR defaults to ~/.cache/sbuild.

COPYRIGHT

       Copyright © 2020 Christian Kastner <ckk@debian.org>

SEE ALSO

       sbuild(1), sbuild-qemu-create(1), sbuild-qemu-update(1).