adt-virt-chroot(1)					     Linux Programmer's Manual						adt-virt-chroot(1)

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 com-
	      mand; 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)