NAME

       adt-build-lxc - Create or update autopkgtest container for adt-virt-lxc

SYNOPSYS

       adt-build-lxc distribution release

DESCRIPTION

       adt-build-lxc  creates  or  updates  an  LXC  container  adt-release which is suitable for
       autopkgtest's LXC runner adt-virt-lxc(1).

       It calls lxc-create with the distribution template  (which  can  currently  be  debian  or
       ubuntu)  and  -rrelease  to  build  a debootstrap-like container, then enables deb-src apt
       sources, and runs apt-get update.

       If the container already exists, it updates it  as  unintrusively  as  possible  by  first
       creating a new temporary container adt-release.new, and then rsyncing its root file system
       back to the existing adt-release.  Note  that  this  could  cause  some  side-effects  and
       breakage  if  you  have  running  containers  with  ephemeral  overlays  (i.  e. using the
       --ephemeral option), but it does work in general. This update process does  not  interfere
       at all if you use adt-virt-lxc with cloning.

       Note  that  you  need  to  call  this  as  root,  unless  you set up LXC to allow per-user
       containers. But user containers will not work with many or even most autopkgtests.

EXAMPLES

       # adt-build-lxc debian sid

       $ sudo adt-build-lxc ubuntu trusty

SEE ALSO

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

AUTHORS AND COPYRIGHT

       adt-build-lxc 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.