NAME

       sbuild-qemu-create - QEMU image creator for sbuild

SYNOPSIS

       sbuild-qemu-create      [-h]      [--arch=ARCH]      [--install-packages=INSTALL_PACKAGES]
       [--extra-deb=EXTRA_DEB]     [--components=COMPONENTS]     [--skel=SKEL]      [--size=SIZE]
       [-o=OUT_FILE] [--noexec] debmirror

       Build   an  image  for  use  with  sbuild-qemu  and  autopkgtest.   distribution  will  be
       debootstrapped using mirror debmirror.  Note that the mirror will also  be  used  for  the
       sources.list file in the VM. See MIRROR below.

       Note  that  sbuild-qemu-create  is  just a simple wrapper around autopkgtest-build-qemu(1)
       that automates a few additional steps commonly performed with package-building images.

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.

       --install-packages=INSTALL_PACKAGES
              Comma-separated  list  of additional packages to install using apt-get install from
              within the running image.

       --extra-deb=EXTRA_DEB
              Package file (.deb) from the local filesystem to install.  Can  be  specified  more
              than once.

       --components=COMPONENTS
              Comma-separated  list  of  components  to  use with sources.list entries.  Default:
              main.

       --skel=SKEL
              Skeleton directory to use for /root.

       --size=SIZE
              VM size to use. Note that the images will be created in qcow2 format, so they won't
              consume that space right away. Default: 10G.

       -o=OUT_FILE, --out-file=OUT_FILE
              Output filename. If not supplied, then DIST-autopkgtest-ARCH.img will be used.

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

MIRROR

       It is highly recommended that you use an APT cache, like approx(8),  or  apt-cacher-ng(8),
       on the local machine (so that the VM guest can access it without much hassle) as a mirror.
       This will dramatically speed up the package build process. On the author's local  machine,
       installing the build dependencies of even larger packages takes only a few seconds.

SPECIAL CASES

       If   the  distribution  is  experimental,  sources.list  will  contain  entries  for  both
       experimental and unstable.

       If the distribution ends with -backports, sources.list will contain entries for  both  the
       distribution and the distribution it is based upon.

SHARING FILES

       Among  other things, autopkgtest-virt-qemu(1) has built-in support for sharing a directory
       on the host with the guest, so no further configuration should be necessary when accessing
       the VM using autopkgtest.

       However, for cases where the VM is launched via QEMU directly, a /shared mount point for a
       9p filesystem has been added to the VM's /etc/fstab. It  is  configured  with  the  nofail
       option, so it will be ignored if nothing is being shared.

       To  share  a  directory on the host with the VM, QEMU should be started with the following
       additional options:

        -virtfs path=/path/to/host/dir,local,id=shared,mount_tag=shared,security_model=none

EXAMPLES

       $ sudo sbuild-qemu-create unstable http://deb.debian.org/debian

       This  will  create  an  image  unstable-autopkgtest-amd64.img  (assuming  that  the   host
       architecture is amd64) with the unstable distribution.

       $ sudo sbuild-qemu-create buster-backports http://deb.debian.org/debian

       This  will  create  an  image  buster-backports-autopkgtest-amd64.img,  with  sources.list
       entries for both buster and buster-backports.

       $ sudo sbuild-qemu-create --skel DIR unstable http://deb.debian.org/debian

       The files in DIR will be copied into /root (that is, root's $HOME). This can be used,  for
       example,  to  copy  an  .ssh/authorized_keys  file, so that one can connect to the running
       image using SSH (assuming openssh-server is installed).

       $     sudo     sbuild-qemu-create     --install-packages      openssh-server      unstable
       http://deb.debian.org/debian

       This  would  install  openssh-server.  The  package  will  be  downloaded  in  the  target
       environment using 'apt-get'.

       A popular package to pre-install this way would be debhelper, as it is a build  dependency
       of the vast majority of Debian packages.

       $ sudo sbuild-qemu-create --extra-deb FOO.deb unstable http://deb.debian.org/debian

       This would install the package FOO.deb from the local filesystem.  Useful, for example, to
       install additional keyring packages.

       $ sudo sbuild-qemu-create --shared-mountpoint unstable http://deb.debian.org/debian

       This will create an image with an fstab entry for the directory /shared.

COPYRIGHT

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

SEE ALSO

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