NAME

       autopkgtest-virt-chroot - autopkgtest virtualisation server using a chroot

SYNOPSIS

       autopkgtest [...] -- chroot [options] [-rgain-root-cmd] /path/to/chroot

DESCRIPTION

       autopkgtest-virt-chroot  provides  an  autopkgtest  virtualisation  server  using a chroot
       install (or similar).

       Normally autopkgtest-virt-chroot will be invoked by autopkgtest.

       The chroot directory to use must be specified.

OPTIONS

       --gain-root|-r gain-root-cmd
              Specifies that autopkgtest-virt-chroot can become root (on the host)  by  prefixing
              its  commands  with  gain-root-cmd.   The  command  may  consist  of  several words
              separated by whitespace, in which case words other than the first are  supplied  as
              additional  arguments  to  the  command;  other  shell (or other) metacharacters in
              gain-root-cmd are not interpreted  or  modified  by  autopkgtest-virt-chroot.   The
              actual  command  to  be  run as root, and its arguments, are supplied as additional
              (separate) arguments to gain-root-cmd.

              Root privilege is needed, to successfully run chroot(8), if the chroot  to  use  is
              specified  as an absolute path.  The default is not to take any special action when
              root  will  be   needed,   in   which   case   for   an   absolute   path   chroot,
              autopkgtest-virt-chroot must be started as root.

       -d | --debug
              Enables debugging output.  Probably not hugely interesting.

INPUT, OUTPUT AND EXIT STATUS

       The   behaviour  of  autopkgtest-virt-chroot  is  as  described  by  the  AutomatedTesting
       virtualisation regime specification.

SEE ALSO

       autopkgtest(1), autopkgtest-schroot(1), /usr/share/doc/autopkgtest/.

AUTHORS AND COPYRIGHT

       This manpage  is  part  of  autopkgtest,  a  tool  for  testing  Debian  binary  packages.
       autopkgtest is Copyright (C) 2006-2007 Canonical Ltd and others.

       See  /usr/share/doc/autopkgtest/CREDITS  for  the  list  of  contributors and full copying
       conditions.