chiark / gitweb /
actually include docs and improve control description a bit
authorIan Jackson <ian@anarres>
Mon, 26 Feb 2007 16:34:37 +0000 (16:34 +0000)
committerIan Jackson <ian@anarres>
Mon, 26 Feb 2007 16:34:37 +0000 (16:34 +0000)
debian/control
virt-subproc/adt-virt-null [new file with mode: 0755]
virt-subproc/adt-virt-null.1 [new file with mode: 0644]
virt-subproc/adt-virt-xenlvm.1 [new file with mode: 0644]

index 7f9efb6e0509f5cb3f7c0962764cd81174196093..10a3ada8ada3d1ae76f285f460012513c07d4eec 100644 (file)
@@ -15,8 +15,10 @@ Description: automatic as-installed testing for Debian packages
  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
diff --git a/virt-subproc/adt-virt-null b/virt-subproc/adt-virt-null
new file mode 100755 (executable)
index 0000000..e1a887b
--- /dev/null
@@ -0,0 +1,73 @@
+#!/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()
diff --git a/virt-subproc/adt-virt-null.1 b/virt-subproc/adt-virt-null.1
new file mode 100644 (file)
index 0000000..f1fc16a
--- /dev/null
@@ -0,0 +1,44 @@
+.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.
diff --git a/virt-subproc/adt-virt-xenlvm.1 b/virt-subproc/adt-virt-xenlvm.1
new file mode 100644 (file)
index 0000000..c831048
--- /dev/null
@@ -0,0 +1,71 @@
+.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.