Man Linux: Main Page and Category List

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.