NAME

       sbuild-qemu - sbuild using QEMU images

SYNOPSIS

       sbuild-qemu        [-h]        [--image=IMAGE]        [--ram-size=MiB]       [--cpus=CPUs]
       [--overlay-dir=OVERLAY_DIR] [--noexec] [--autopkgtest-debug] [<sbuild-options>]

       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(1), though
       the options --dist, --arch and --build are peeked at when looking for  images.  The  image
       will  be started in -snapshot mode, so the image is never modified. Multiple processes can
       use the same image concurrently.

OPTIONS

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

       --image=IMAGE
              QEMU image file to use for building. If not specified, sbuild-qemu will look for an
              image  with  the name DIST-autopkgtest-ARCH.img, where DIST is taken from --dist if
              present, and ARCH is taken from --arch  or  --build  if  present.  Otherwise,  DIST
              defaults  to  'unstable', and ARCH to the host architecture. sbuild-qemu will first
              look in the current directory  for  such  an  image,  and  then  in  the  directory
              $IMAGEDIR. A suitable image can be created with sbuild-qemu-create(1).

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

       --cpus=CPUs
              VM CPU count. Default: 2

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

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

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-2022 Christian Kastner <ckk@debian.org>

SEE ALSO

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