NAME

       sbuild-qemu - sbuild using QEMU images

SYNOPSIS

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

       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, with the
       exception of --dist (it is both consumed here, and passed on). 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, arm64, armhf, i386, ppc64el.

       -d=DIST, --dist=DIST
              This  corresponds  to  sbuild's  --dist  option.  It  is  used  here to construct a
              candidate image name (if no image has been specified explicitly).

       --image=IMAGE
              QEMU image file 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).

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