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.