NAME

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

SYNOPSYS

       adt-virt-chroot [options] =[chroot-name]
       adt-virt-chroot [options] [-rgain-root-cmd] /path/to/chroot

DESCRIPTION

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

       Normally adt-virt-chroot will be invoked by adt-run.

       The  chroot  to  use  must be specified.  If it starts with a = character then it is taken to be a chroot
       name known to dchroot(8).  Otherwise it must start with a / and will be taken to an absolute path.

OPTIONS

       --gain-root|-r gain-root-cmd
              Specifies that adt-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 adt-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, adt-virt-chroot must be started as root.

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

INPUT, OUTPUT AND EXIT STATUS

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

SEE ALSO

       adt-run(1), adt-virt-null(1), adt-virt-xenlvm(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.

autopkgtest                                           2007                                    adt-virt-chroot(1)