NAME¶
adt-virt-schroot - autopkgtest virtualisation server using a schroot
SYNOPSYS¶
adt-virt-schroot [
options]
schroot-name
DESCRIPTION¶
adt-virt-schroot provides an autopkgtest virtualisation server using a
schroot. Normally
adt-virt-schroot will be invoked by
adt-run.
The schroot name to use must be specified.
Only use this with schroots
that provide temporary sessions, i. e. with
type=file or
type=directory and a configured
union-type.
adt-virt-schroot will refuse to work with a static
"directory" type schroot.
You can use
mk-sbuild(1) to conveniently create schroots.
PERMISSIONS¶
If you can access the schroot as your user (according to the schroot's
users/
groups configuration), you should run
adt-virt-schroot
(and adt-test) as normal user, too.
adt-virt-schroot reads the schroot configuration (
root-users/
root-groups) to determine whether it can enter the
schroot as root user; if so, it sets the
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
adt-run as root instead.
OPTIONS¶
- -s ID | --session-id=ID
- Use a custom schroot session ID. This allows the user to easily identify
hung sessions in schroot --list --all-sessions.
- -d | --debug
- Enables debugging output.
The behaviour of
adt-virt-schroot is as described by the AutomatedTesting
virtualisation regime specification.
SEE ALSO¶
adt-run(1),
adt-virt-null(1),
schroot(1),
mk-sbuild(1).
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
/usr/share/doc/autopkgtest/CREDITS for the list of contributors and
full copying conditions.