virt-subproc/adt-virt-xenlvm.1

   1 .TH adt\-virt-xenlvm 1 2007 autopkgtest "Linux Programmer's Manual"
   2 .SH NAME
   3 adt\-virt\-xenlvm \- autopkgtest virtualisation server using Xen and LVM
   4 .SH SYNOPSYS
   5 .B adt\-virt\-xenlvm
   6 .RI [ options ]
   7 .B \-\-
   8 .RI [ "adt-xenlvm options" ]
   9 .SH DESCRIPTION
  10 .B adt-virt-xenlvm
  11 provides an autopkgtest virtualisation server using a Xen virtual
  12 machine and LVM snapshots.  It adapts the raw functionality provided
  13 by the
  14 .BR adt-xenlvm- *
  15 tools for use by autopkgtest.
  16
  17 Normally
  18 .B adt-virt-xenlvm
  19 will be invoked by
  20 .BR adt-run .
  21
  22 .BR adt-virt-xenlvm
  23 uses
  24 .BR adt-xenlvm-with-testbed
  25 and
  26 .BR adt-xenlvm-on-testbed .
  27 The testbed must have previously been set up with
  28 .BR adt-xenlvm-setup .
  29
  30 Neither
  31 .BR adt-virt-xenlvm
  32 nor
  33 .BR adt-xenlvm-with-testbed
  34 do any locking; it is the the caller's responsibility not to attempt
  35 concurrent use of any particular testbed.
  36 .SH OPTIONS
  37 .TP
  38 .BI --distro= distro
  39 Specifies a different distro (ie, the use of a different testbed).
  40 .TP
  41 .BI --nominum= nominum
  42 Specifies a different nominum (ie, the use of a different testbed).
  43 .TP
  44 .BR \-\-userv
  45 Specifies that the adt-xenlvm tools should not be run directly, but
  46 rather via userv.  The calling user must be permitted to use
  47 .BR "userv root adt-xenlvm-testbed" .
  48 In the default configuration, this means being a member of the
  49 .B AdtXenUs
  50 group.
  51 .TP
  52 .BI "-- --" adt-xenlvm-option = adt-xenlvm-value
  53 Following the first occurrence of
  54 .B --
  55 on the
  56 .B adt-virt-xenlvm
  57 commandline, any of the values in the adt-xenlvm configuration may be
  58 set in the usual way.  The arguments are simply passed to
  59 \fBadt-virt-xenlvm\fR.
  60
  61 See \fB/usr/share/doc/autopkgtest-xenlvm/README.gz\fR for full details
  62 of adt-xenlvm.
  63 .TP
  64 .BI "-- -D" varname = value
  65 If \fB\-\-userv\fR was specified, options following the first
  66 .B --
  67 on the
  68 .B adt-virt-xenlvm
  69 commandline are passed as option arguments to \fBuserv\fR.  These
  70 should normally be user-defined variable settings using \fB-D\fR which
  71 are expected by the \fBautopkgtest-xenlvm/userv-target\fR script.
  72 Currently only \fBdistro\fR and \fBnominum\fR are expected, and these
  73 can be set using \fBadt-virt-xenlvm\fR's own options.
  74 .TP
  75 .BR \-d " | " \-\-debug
  76 Enables debugging output.  Probably not hugely interesting.
  77 .SH INPUT, OUTPUT AND EXIT STATUS
  78 The behaviour of
  79 .B adt-virt-xenlvm
  80 is as described by the AutomatedTesting virtualisation regime
  81 specification.
  82
  83 .SH SEE ALSO
  84 \fBadt-run\fR(1),
  85 \fBadt\-virt-null\fR(1),
  86 \fBadt\-virt-chroot\fR(1),
  87 \fB/usr/share/doc/autopkgtest/\fR,
  88 \fB/usr/share/doc/autopkgtest-xenlvm/README.gz\fR.
  89
  90 .SH AUTHORS AND COPYRIGHT
  91 This manpage is part of autopkgtest, a tool for testing Debian binary
  92 packages.  autopkgtest is Copyright (C) 2006-2007 Canonical Ltd and others.
  93
  94 See \fB/usr/share/doc/autopkgtest/CREDITS\fR for the list of
  95 contributors and full copying conditions.