adt-virt-chroot [options] =[chroot-name]

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


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.


--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.


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

RELATED TO adt-virt-chroot…

adt-run(1), adt-virt-schroot(1), /usr/share/doc/autopkgtest/.


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.