NAME

       adt-virt-xenlvm - autopkgtest virtualisation server using Xen and LVM

SYNOPSYS

       adt-virt-xenlvm [options] -- [adt-xenlvm options]

DESCRIPTION

       adt-virt-xenlvm  provides an autopkgtest virtualisation server using a Xen virtual machine
       and LVM snapshots.  It adapts the raw functionality provided by the adt-xenlvm-* tools for
       use by autopkgtest.

       Normally adt-virt-xenlvm will be invoked by adt-run.

       adt-virt-xenlvm  uses adt-xenlvm-with-testbed and adt-xenlvm-on-testbed.  The testbed must
       have previously been set up with adt-xenlvm-setup.

       Neither adt-virt-xenlvm nor adt-xenlvm-with-testbed do any locking; it is the the caller's
       responsibility not to attempt concurrent use of any particular testbed.

OPTIONS

       --distro=distro
              Specifies a different distro (ie, the use of a different testbed).

       --nominum=nominum
              Specifies a different nominum (ie, the use of a different testbed).

       --userv
              Specifies  that  the  adt-xenlvm  tools  should not be run directly, but rather via
              userv.  The calling user must be permitted to use  userv  root  adt-xenlvm-testbed.
              In the default configuration, this means being a member of the AdtXenUs group.

       -- --adt-xenlvm-option=adt-xenlvm-value
              Following the first occurrence of -- on the adt-virt-xenlvm commandline, any of the
              values in the adt-xenlvm configuration may be set in the usual way.  The  arguments
              are simply passed to adt-virt-xenlvm.

              See /usr/share/doc/autopkgtest-xenlvm/README.gz for full details of adt-xenlvm.

       -- -Dvarname=value
              If  --userv  was  specified,  options following the first -- on the adt-virt-xenlvm
              commandline are passed as option arguments to  userv.   These  should  normally  be
              user-defined  variable  settings  using  -D  which are expected by the autopkgtest-
              xenlvm/userv-target script.  Currently only distro and nominum  are  expected,  and
              these can be set using adt-virt-xenlvm's own options.

       -d | --debug
              Enables debugging output.  Probably not hugely interesting.

INPUT, OUTPUT AND EXIT STATUS

       The  behaviour  of  adt-virt-xenlvm is as described by the AutomatedTesting virtualisation
       regime specification.

SEE ALSO

       adt-run(1),     adt-virt-null(1),     adt-virt-chroot(1),     /usr/share/doc/autopkgtest/,
       /usr/share/doc/autopkgtest-xenlvm/README.gz.

AUTHORS AND COPYRIGHT

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

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