chiark / gitweb /
Truncate files when writing them (!); fix message not to have spurious \; reset signa...
[autopkgtest.git] / 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 .BR \-d " | " \-\-debug
39 Enables debugging output.  Probably not hugely interesting.
40 .TP
41 .BI "-- --" adt-xenlvm-option = adt-xenlvm-value
42 Following the first occurrence of
43 .B --
44 on the
45 .B adt-virt-xenlvm
46 commandline, any of the values in the adt-xenlvm configuration may be
47 set in the usual way.  In particular,
48 .BI --nominum= nominum
49 can be used to specify the use of a different testbed.
50
51 See \fB/usr/share/doc/autopkgtest-xenlvm/README.gz\fR for full details
52 of adt-xenlvm.
53 .SH INPUT, OUTPUT AND EXIT STATUS
54 The behaviour of
55 .B adt-virt-xenlvm
56 is as described by the AutomatedTesting virtualisation regime
57 specification.
58
59 .SH SEE ALSO
60 \fBadt-run\fR(1),
61 \fBadt\-virt-null\fR(1),
62 \fBadt\-virt-chroot\fR(1),
63 \fB/usr/share/doc/autopkgtest/\fR,
64 \fB/usr/share/doc/autopkgtest-xenlvm/README.gz\fR.
65
66 .SH AUTHORS AND COPYRIGHT
67 This manpage is part of autopkgtest, a tool for testing Debian binary
68 packages.  autopkgtest is Copyright (C) 2006-2007 Canonical Ltd and others.
69
70 See \fB/usr/share/doc/autopkgtest/CREDITS\fR for the list of
71 contributors and full copying conditions.