NAME

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

SYNOPSIS

       autopkgtest-build-lxc [--keyring=path] distribution release [architecture] [script]

DESCRIPTION

       autopkgtest-build-lxc  creates  or  updates  an LXC container autopkgtest-release which is
       suitable for autopkgtest's LXC runner autopkgtest-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.

       It defaults to the native architecture, but you can  specify  a  different  one  as  third
       parameter.

       The path to a script to be executed inside the container to customize the container can be
       passed as the fourth parameter. The script must be a POSIX shell script,  and  should  not
       depend on bash-specific features.

       If  the  container  already  exists,  it  updates it as unintrusively as possible by first
       creating a new temporary container autopkgtest-release.new, and  then  rsyncing  its  root
       file  system  back  to  the  existing autopkgtest-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 autopkgtest-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.

OPTIONS

       --keyring=KEYRING

              Specify  the  path to a keyring used to verify the apt repository.  By default, the
              choice of keyring will be left to debootstrap.  This option is  mainly  useful  for
              use with a Debian derivative in conjunction with the MIRROR environment variable.

ENVIRONMENT

       If  the  $AUTOPKGTEST_KEEP_APT_SOURCES  environment  variable is set to a non-empty value,
       autopkgtest-build-lxc will keep whatever /etc/apt/sources.list was created by lxc-create.

       Otherwise, if the $AUTOPKGTEST_APT_SOURCES_FILE environment variable is set to a non-empty
       value,   for   example  AUTOPKGTEST_APT_SOURCES_FILE=/home/me/mydistro/sources.list,  then
       autopkgtest-build-lxc will read that file (on the host system)  and  use  it  to  populate
       /etc/apt/sources.list  in  the  container;  or if the $AUTOPKGTEST_APT_SOURCES environment
       variable  is  set  to  a  non-empty  value,  for   example   AUTOPKGTEST_APT_SOURCES=$(cat
       /home/me/mydistro/sources.list),   autopkgtest-build-lxc   will  write  it  directly  into
       /etc/apt/sources.list in the container.

       You can specify an apt proxy  to  use  in  the  container  in  the  $AUTOPKGTEST_APT_PROXY
       environment  variable. If you have an apt proxy configured on the host, the container will
       automatically use this, otherwise there is no default.

EXAMPLES

       # autopkgtest-build-lxc debian sid

       $ sudo autopkgtest-build-lxc ubuntu trusty i386

SEE ALSO

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

AUTHORS AND COPYRIGHT

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