Provided by: autopkgtest_5.5ubuntu1_all bug

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.