NAME

       adt-virt-lxc - autopkgtest virtualisation server using LXC

SYNOPSYS

       adt-virt-lxc [options] lxc-container

DESCRIPTION

       adt-virt-lxc  provides  an  autopkgtest  virtualisation server using LXC. It adapts the raw functionality
       provided by the lxc-* tools for use by autopkgtest.

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

       You can conveniently create a suitable container using the adt-build-lxc(1) script.

REQUIREMENTS

       adt-virt-lxc assumes that you have already prepared a suitable Debian  based  LXC  container.   See  lxc-
       create(1) for how to create containers.

OPTIONS

       -e | --ephemeral
              This  option  makes  use of lxc-start-ephemeral to create temporary container overlays, instead of
              the default behaviour of cloning your  containers.  This  can  be  used  to  dramatically  improve
              performance,  although  you  may  see issues due to the overlayfs filesystem as used by lxc-start-
              ephemeral not being completely transparent (e. g. seen with tar failing when  running  LXC  within
              Qemu).  Before using this option in automation you should ensure that tests that involve large I/O
              work as expected.

       -s | --sudo
              Run lxc-* commands through sudo; use this option if you run adt-run as normal user,  but  need  to
              run the container itself as root (if you use LXC system level containers).

       --eatmydata
              This  option  is  intended  for  test developer use. It enables the use of eatmydata(1) inside the
              container on all commands in order to improve performance. This requires eatmydata(1)  to  already
              be installed inside the supplied template, which you will need to do manually.

              However,  since  eatmydata  is  not  part  of  the  dep8  specification  and  may  affect the test
              environment, it is not recommended for use in automation.

       -d | --debug
              Enables debugging output.

INPUT, OUTPUT AND EXIT STATUS

       The  behaviour  of  adt-virt-lxc  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 release template. You will  need  to  run  apt-get  update  in  the  template
       yourself (e. g. using --setup-commands).

EXAMPLE

       Create  a  suitable  debootstrap-based  container  for Debian or Ubuntu template, e.  g. a Debian sid one
       (will be named adt-sid):

              adt-build-lxc debian sid

       Or an Ubuntu one  based  on  the  cloud  images  (faster  than  adt-build-lxc's  "ubuntu"  template  with
       debootstrap, but much bigger):

              lxc-create -t ubuntu-cloud -n adt-trusty -- -r trusty -d daily

       Run  tests  against  hello_2.8-4.dsc,  using the LXC container adt-sid, and with an ephemeral overlay for
       speed:

              adt-run hello_2.8-4.dsc --- adt-virt-lxc -e adt-sid

SEE ALSO

       adt-run(1), adt-build-lxc(1), lxc-create(1), eatmydata(1), /usr/share/doc/autopkgtest/.

AUTHORS AND COPYRIGHT

       adt-virt-lxc   was   written   by   Robie   Basak    <robie.basak@canonical.com>    and    Martin    Pitt
       <martin.pitt@ubuntu.com>.

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

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