NAME

       adt-virt-schroot - autopkgtest virtualisation server using a schroot

SYNOPSIS

       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.

autopkgtest                                           2013                                   adt-virt-schroot(1)