Scroll to navigation

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

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.
 

INPUT, OUTPUT AND EXIT STATUS

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