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.