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.