NAME

       adt-virt-lxc - autopkgtest virtualisation server using LXC

SYNOPSIS

       adt-virt-lxc [options] lxc-container [-- extra lxc-start args...]

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,  and particularly adt-build-lxc(1) for conveniently creating
       standard autopkgtest 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.

              Note that ephemeral containers do not support rebooting with LXC 1.x. This does work with  LXC  >=
              2.x.

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

        --name NAME
              Set a custom name for the temporary container in which to run the test. This is  autogenerated  by
              default  (adt-virt-lxc-XXXXXX), but if you have a way to generate more expressive unique names you
              can use that to make it easier to map containers to running tests.

       -d | --debug
              Enables debugging output.

       You can pass additional options to LXC: Anything after a -- gets passed verbatim to  lxc-start/lxc-start-
       ephemeral.

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

Linux Programmer's Manual                             2013                                       adt-virt-lxc(1)