NAME

       adt-virt-qemu - autopkgtest virtualisation server using QEMU

SYNOPSYS

       adt-virt-qemu [options] image [ro-image ...]

DESCRIPTION

       adt-virt-qemu provides an autopkgtest virtualisation server using QEMU.

       Normally adt-virt-qemu will be invoked by adt-run.

       You  always  need  to  specify  at  least one QEMU VM image. If your VM needs more disks, you can specify
       arbitrarily many additional images which will be added in order.

       adt-virt-qemu does not modify the given images, but will instead  create  a  temporary  overlay  for  the
       primary image, and add all other images as read-only.

REQUIREMENTS

       adt-virt-qemu  assumes  that  you  have already prepared a suitable Debian based QEMU image (see BUILDING
       IMAGES below for how to create them). but you can use any VM which satisfies one of:

       *   They open a root shell on ttyS1, or

       *   They have a serial console on ttyS0 where you can log in (getty or similar) with specified  user  and
           password. This will then be used to start a root shell on ttyS1, to reduce this to the first case and
           to not assume that ttyS0 stays operational throughout the whole test.

OPTIONS

       -u user | --user=user

              User name for running tests that don't require root privileges.

              If  the  VM  is  not  already  prepared  to start a root shell on ttyS1 this will be also used for
              logging in on ttyS0. If this is not root, it must be able to run sudo without a password to become
              root for that purpose.

       -p password | --password=password
              Password for above user for logging into the VM on ttyS0. This is  necessary  if  the  VM  is  not
              already prepared to start a root shell on ttyS1.

       -q command | --qemu-command=command
              QEMU command to run. This defaults to the qemu-system-* that matches your system architecture.

       -o dir | --overlay-dir=dir
              Directory where the temporary image overlay for the primary image is created. By default this will
              happen  in  a  work  directory in /tmp (or $TMPDIR), but you can use this to e. g. ensure that the
              overlay is placed on a tmpfs if your /tmp directory is not on tmpfs. This  will  greatly  increase
              the speed.

       --ram-size=MiB
              VM RAM size in MiB. Default is 1024, i. e. 1 GiB.

       -d | --debug
              Enable debugging output.

CONFIGURATION FILES

       If  you  use lots of options or images, you can put parts of, or the whole command line into a text file,
       with one line per option. E. g. you can create a file sid-desktop.cfg with contents like

              -utestuser
              -ps3kr1t
              --ram-size=4096
              /home/bob/autopkgtest/sid-desktop.img

       and then run

              adt-run [...] --- adt-virt-qemu @sid-desktop.cfg

       The contents of the configuration file will be expanded in-place as if you would have given its  contents
       on  the  command  line. Please ensure that you don't place spaces between short options and their values,
       they would become a part of the argument value.

INPUT, OUTPUT AND EXIT STATUS

       The  behaviour  of  adt-virt-qemu  is  as  described  by  the  AutomatedTesting   virtualisation   regime
       specification.

NOTES

       adt-run  does  not run apt-get update at the start of a package build, which can cause a build failure if
       you are using a development series template. You will need to run apt-get update in the template yourself
       (e. g. using --setup-commands).

BUILDING IMAGES

   Debian
       For Debian you can use vmdebootstrap(8) to build a suitable image. E. g. for unstable:

              vmdebootstrap --verbose --serial-console --distribution=sid \
                 --customize=/usr/share/autopkgtest/adt-setup-vm \
                 --user=adt/adt --size=10000000000 --image=adt-sid.raw
              qemu-img convert -O qcow2 adt-sid.raw  adt-sid.img
              rm adt-sid.raw

       vmdebootstrap can only create a raw format image; it is recommended to convert it to  qcow2  as  that  is
       much  smaller  (in  the  order  of  700  MB for qcow2 vs. the 10 GB as specified above) and also supports
       additional features such as snapshots  or  compression.  You  can  run  that  command  with  setting  the
       environment variable ADT_APT_PROXY to a proxy. E. g. if you have apt-cacher-ng installed on the host, you
       can run

              ADT_APT_PROXY=http://10.0.2.2:3142 vmdebootstrap [...]

   Ubuntu
       For  Ubuntu,  autopkgtest  provides  adt-buildvm-ubuntu-cloud(1)  to build a VM based on the Ubuntu cloud
       images. To create an image for the current development series and the i386 architecture:

              adt-buildvm-ubuntu-cloud -v -a i386

       This will produce e. g.  adt-trusty-i386-cloud.img.

EXAMPLE

       Run the tests of the libpng source package, using an Ubuntu cloud image:

              adt-run libpng --- adt-virt-qemu adt-trusty-i386-cloud.img

SEE ALSO

       adt-run(1),   adt-virt-schroot(1),   adt-virt-lxc(1),   adt-buildvm-ubuntu-cloud(1),    vmdebootstrap(8),
       /usr/share/doc/autopkgtest/.

AUTHORS AND COPYRIGHT

       adt-virt-qemu was written by Martin Pitt <martin.pitt@ubuntu.com>

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

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

Linux Programmer's Manual                             2014                                      adt-virt-qemu(1)