autopkgtst-chroot(1) autopkgtest virtualisation server using a chroot

SYNOPSIS

autopkgtest [...] -- chroot [options] [-rgain-root-cmd] /path/to/chroot

DESCRIPTION

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

Normally autopkgtest-chroot will be invoked by autopkgtest.

The chroot directory to use must be specified.

OPTIONS

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

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

INPUT, OUTPUT AND EXIT STATUS

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

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.