From: Ian Jackson Date: Mon, 26 Feb 2007 16:34:37 +0000 (+0000) Subject: actually include docs and improve control description a bit X-Git-Tag: converted-from-bzr~32^3~22 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=9b529ae843431bc0c7bd134c2f1b2d7f288c43ad;p=autopkgtest.git actually include docs and improve control description a bit --- diff --git a/debian/control b/debian/control index 7f9efb6..10a3ada 100644 --- a/debian/control +++ b/debian/control @@ -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 index 0000000..e1a887b --- /dev/null +++ b/virt-subproc/adt-virt-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 []" + 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 index 0000000..f1fc16a --- /dev/null +++ b/virt-subproc/adt-virt-null.1 @@ -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 index 0000000..c831048 --- /dev/null +++ b/virt-subproc/adt-virt-xenlvm.1 @@ -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.