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.

Linux Programmer's Manual                             2014                                      adt-build-lxc(1)