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.

       When $AUTOPKGTEST_APT_SOURCES_FILE or  $AUTOPKGTEST_APT_SOURCES  contain  sources  in  the
       deb822 format, then sources are written to /etc/apt/sources.list.d/<distro>.sources in the
       virtual container, rather than /etc/apt/sources.list.

       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.  In case you want to  prevent  your
       local   proxy   to   be   picked  up  you  can  specify  UNCONFIGURED  as  the  value  for
       $AUTOPKGTEST_APT_PROXY.

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.