.TH adt\-virt\-schroot 1 2013 autopkgtest "Linux Programmer's Manual"

.SH NAME
adt\-virt\-schroot \- autopkgtest virtualisation server using a schroot
.SH SYNOPSYS
.B adt\-virt\-schroot
.RI [ options ]
.I schroot\-name

.SH DESCRIPTION
.B adt\-virt\-schroot
provides an autopkgtest virtualisation server using a schroot.
Normally
.B adt\-virt\-schroot
will be invoked by
.BR adt\-run .

The schroot name to use must be specified.
.B Only
use this with schroots that provide temporary sessions, i. e. with
.B type=file
or
.B type=directory
and a configured
.BR union\-type .
.B adt\-virt\-schroot
will refuse to work with a static "directory" type schroot.

You can use
.BR mk-sbuild (1)
to conveniently create schroots.

.SH PERMISSIONS
If you can access the schroot as
your user (according to the schroot's \fBusers\fR/\fBgroups\fR configuration),
you should run
.B adt\-virt\-schroot (and \fBadt\-test\fR) as normal user, too.

.B adt\-virt\-schroot
reads the schroot configuration (\fBroot-users\fR/\fBroot-groups\fR) to
determine whether it can enter the schroot as root user; if so, it sets the
.B root\-on\-testbed
capability and you can run tests which require building or running as root. If
your user is not allowed to do that, you need to run
.B adt\-run
as root instead.

.SH OPTIONS
.TP
.BI -s " ID" " | --session-id=" ID
Use a custom schroot session ID. This allows the user to easily
identify hung sessions in
.B schroot --list --all-sessions\fR.

.TP
.BR \-d " | " \-\-debug
Enables debugging output.

.SH INPUT, OUTPUT AND EXIT STATUS
The behaviour of
.B adt-virt-schroot
is as described by the AutomatedTesting virtualisation regime
specification.

.SH SEE ALSO
.BR adt\-run (1),
.BR adt\-virt-null (1),
.BR schroot (1),
.BR mk\-sbuild (1).

.SH AUTHORS AND COPYRIGHT
This manpage is part of autopkgtest, a tool for testing Debian binary
packages.  autopkgtest is Copyright (C) 2006-2013 Canonical Ltd and others.

See \fB/usr/share/doc/autopkgtest/CREDITS\fR for the list of
contributors and full copying conditions.