autopkgtest runs tests on binary packages. The tests are run on the
package as installed on a testbed system (which may be found via a
virtualisation or containment system). The tests are expected to be
- supplied in the corresponding Debian source package. See adt-run(1)
- and /usr/share/doc/autopkgtest.
+ supplied in the corresponding Debian source package.
+ .
+ See adt-run(1) and /usr/share/doc/autopkgtest.
+ Use of adt-virt-xenlvm requires the autopkgtest-xenlvm package too.
Package: autopkgtest-xenlvm
Architecture: all
--- /dev/null
+#!/usr/bin/python2.4
+#
+# adt-virt-null is part of autopkgtest
+# autopkgtest is a tool for testing Debian binary packages
+#
+# autopkgtest is Copyright (C) 2006-2007 Canonical Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+#
+# See the file CREDITS for a full list of credits information (often
+# installed as /usr/share/doc/autopkgtest/CREDITS).
+
+import sys
+import os
+import string
+from optparse import OptionParser
+
+try: our_base = os.environ['AUTOPKGTEST_BASE']
+except KeyError: our_base = '/usr/share/autopkgtest';
+sys.path.insert(1, our_base+'/python')
+
+import VirtSubproc as vsp
+capabilities = []
+
+def parse_args():
+ global down, debuglevel
+
+ usage = "%prog [<options>]"
+ parser = OptionParser(usage=usage)
+ pa = parser.add_option
+ pe = parser.error
+
+ pa('-d', '--debug', action='store_true', dest='debug');
+
+ (opts,args) = parser.parse_args()
+ if len(args): pe("no arguments allowed")
+
+ vsp.debuglevel = opts.debug
+
+ if os.getuid()==0:
+ capabilities.append('root-on-testbed')
+
+ vsp.down = []
+
+def hook_open():
+ global downtmp
+ vsp.execute('true', downp=True)
+ downtmp = vsp.execute('mktemp -t -d', downp=True, outp=True)
+ return downtmp
+
+def hook_cleanup():
+ vsp.execute('rm -rf --', [downtmp], downp=True)
+
+def hook_forked_inchild():
+ pass
+
+def hook_capabilities():
+ return capabilities
+
+parse_args()
+vsp.main()
--- /dev/null
+.TH adt\-virt\-null 1 2007 autopkgtest "Linux Programmer's Manual"
+.SH NAME
+adt\-virt\-null \- autopkgtest null virtualisation server
+.SH SYNOPSYS
+.B adt\-virt\-null
+.RI [ options ]
+.br
+.SH DESCRIPTION
+.B adt\-virt\-null
+provides a dummy autopkgtest virtualisation server which does not
+actually offer any kind of separation between host and testbed.
+
+Normally
+.B adt-virt-null
+will be invoked by
+.BR adt-run .
+
+There is of course no locking; nothing prevents multiple simultaneous
+programs from invoking
+.B adt-virt-null
+so as to reuse the same system as a testbed.
+.SH OPTIONS
+.TP
+.BR \-d " | " \-\-debug
+Enables debugging output. Probably not hugely interesting.
+
+.SH INPUT, OUTPUT AND EXIT STATUS
+The behaviour of
+.B adt-virt-null
+is as described by the AutomatedTesting virtualisation regime
+specification.
+
+.SH SEE ALSO
+\fBadt\-run\fR(1),
+\fBadt\-virt-chroot\fR(1),
+\fBadt\-virt-xenlvm\fR(1),
+\fB/usr/share/doc/autopkgtest/\fR.
+
+.SH 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 \fB/usr/share/doc/autopkgtest/CREDITS\fR for the list of
+contributors and full copying conditions.
--- /dev/null
+.TH adt\-virt-xenlvm 1 2007 autopkgtest "Linux Programmer's Manual"
+.SH NAME
+adt\-virt\-xenlvm \- autopkgtest virtualisation server using Xen and LVM
+.SH SYNOPSYS
+.B adt\-virt\-xenlvm
+.RI [ options ]
+.B \-\-
+.RI [ "adt-xenlvm options" ]
+.SH DESCRIPTION
+.B adt-virt-xenlvm
+provides an autopkgtest virtualisation server using a Xen virtual
+machine and LVM snapshots. It adapts the raw functionality provided
+by the
+.BR adt-xenlvm- *
+tools for use by autopkgtest.
+
+Normally
+.B adt-virt-xenlvm
+will be invoked by
+.BR adt-run .
+
+.BR adt-virt-xenlvm
+uses
+.BR adt-xenlvm-with-testbed
+and
+.BR adt-xenlvm-on-testbed .
+The testbed must have previously been set up with
+.BR adt-xenlvm-setup .
+
+Neither
+.BR adt-virt-xenlvm
+nor
+.BR adt-xenlvm-with-testbed
+do any locking; it is the the caller's responsibility not to attempt
+concurrent use of any particular testbed.
+.SH OPTIONS
+.TP
+.BR \-d " | " \-\-debug
+Enables debugging output. Probably not hugely interesting.
+.TP
+.BI "-- --" adt-xenlvm-option = adt-xenlvm-value
+Following the first occurrence of
+.B --
+on the
+.B adt-virt-xenlvm
+commandline, any of the values in the adt-xenlvm configuration may be
+set in the usual way. In particular,
+.BI --nominum= nominum
+can be used to specify the use of a different testbed.
+
+See \fB/usr/share/doc/autopkgtest-xenlvm/README.gz\fR for full details
+of adt-xenlvm.
+.SH INPUT, OUTPUT AND EXIT STATUS
+The behaviour of
+.B adt-virt-xenlvm
+is as described by the AutomatedTesting virtualisation regime
+specification.
+
+.SH SEE ALSO
+\fBadt-run\fR(1),
+\fBadt\-virt-null\fR(1),
+\fBadt\-virt-chroot\fR(1),
+\fB/usr/share/doc/autopkgtest/\fR,
+\fB/usr/share/doc/autopkgtest-xenlvm/README.gz\fR.
+
+.SH 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 \fB/usr/share/doc/autopkgtest/CREDITS\fR for the list of
+contributors and full copying conditions.