[Piuparts-commits] [SCM] piuparts git repository branch, piatti, updated. 0.44-827-g219614b

Wed Jun 20 23:15:06 UTC 2012

The following commit has been merged in the piatti branch:
commit 866791141424328f08553f2d68322592bcabef47
Author: Andreas Beckmann <debian at abeckmann.de>
Date:   Wed Jun 20 11:29:37 2012 +0200

    documentation updates
    
    Signed-off-by: Andreas Beckmann <debian at abeckmann.de>

diff --git a/Makefile b/Makefile
index 3231651..6cee024 100644
--- a/Makefile
+++ b/Makefile
@@ -109,4 +109,5 @@ check:
 	python unittests.py
 
 clean:
-	rm -rf piuparts.1 piuparts.1.xml piuparts.1.html piuparts README.xml README.html docbook-xsl.css piuparts.html
+	rm -f piuparts.1 piuparts.1.xml piuparts.1.html piuparts README.xml README.html docbook-xsl.css piuparts.html
+	rm -f *.pyc piupartslib/*.pyc
diff --git a/README.txt b/README.txt
index ed0a9a9..ef87fdb 100644
--- a/README.txt
+++ b/README.txt
@@ -343,7 +343,7 @@ Success: ok
 ----
 
 Slave informs master it cannot test the desired version of a
-package (perhaps it went away from the mirror?).
+package and the package should be rescheduled by the master.
 
 ----
 Command: pass <packagename> <packageversion>
@@ -372,8 +372,8 @@ Command: untestable <packagename> <packageversion>
 Success: ok
 ----
 
-Slave reports that a particular package is untestable, possibly
-because it insists on interacting with the user.
+Slave informs master it cannot test the desired version of a
+package (perhaps it went away from the mirror?).
 
 ----
 Command: status
@@ -381,7 +381,8 @@ Success: ok <package-state>=<count> <package-state>=<count>...
 ----
 Slave asks master to report the number of packages in all
 different states. The "status" command should only be issued
-after all "pass" and "fail" commands.
+after all logs have been transmitted ("pass", "fail", and
+"untestable" commands).
 
 In all cases, if the master cannot respond with "ok" (e.g.,
 because of a disk error storing a log file), it aborts and the
diff --git a/README_piatti.txt b/README_piatti.txt
index 6f88577..7cfaced 100644
--- a/README_piatti.txt
+++ b/README_piatti.txt
@@ -76,7 +76,11 @@ holger at piatti:~$ sudo /home/piupartss/bin/slave_run
 
 There are several cronjobs installed via '~piupartsm/crontab' and '~piupartss/crontab') which monitor the slave and the host it's running on.
 
-It's possible to kill the slave any time by pressing CTRL-C, the currently done test will be redone.
+It's possible to kill the slave any time by pressing Ctrl-C.
+Pressing Ctrl-C once will wait for the current test to finish,
+pressing twice will abort the currently running test (which will be redone).
+Clean termination may take some time and can be aborted by a third Ctrl-C,
+but that may leave temporary directories and processes around.
 
 === Joining an existing slave session
 
@@ -111,7 +115,7 @@ More checks should be added as we become aware of them.
 
 == Authors
 
-Last updated: February 2011
+Last updated: June 2012
 
 Holger Levsen <holger at debian.org>
 Luk Claes <luk at debian.org>
diff --git a/README_server.txt b/README_server.txt
index 93c59ed..8b10570 100644
--- a/README_server.txt
+++ b/README_server.txt
@@ -2,11 +2,12 @@ The piuparts-server package installs a piuparts server along the lines of
 http://piuparts.debian.org/.
 
 Before running the server, edit /etc/piuparts.conf appropriately, to define
-'sections' to be tested (e.g. 'sid') and define references to the Debian mirror
-and Packages files. Note that the server can place a significant load on the
+'sections' to be tested (e.g. 'sid') and define references to the Debian
+mirror. Note that the server can place a significant load on the
 repository. Consider setting up a local mirror, or a caching proxy for http
 and apt-get, to reduce the load.
 
+Edit /etc/sudoers.d/piuparts to grant permissions to the piupartss user.
 Start the server using /usr/sbin/piuparts_slave_run, which will launch a
 'screen' session. The slave will launch a master process via ssh, as needed,
 to retrieve work and return results. Use /usr/sbin/piuparts_slave_join to
diff --git a/piuparts.1.txt b/piuparts.1.txt
index 13b0453..9aef03c 100644
--- a/piuparts.1.txt
+++ b/piuparts.1.txt
@@ -20,7 +20,7 @@ By default, piuparts can do three different tests:
 
 . A simple install-purge test within one Debian distribution (chosen with the '-d' option, unstable by default). It sets up the chroot with the desired distribution, then installs and purges the packages, and reports problems.
 
-. A simple install-upgrade-purge test within one Debian distribution. This test is like the install-purge test, but install the packages first via *apt-get* and then from the package files given on the command line. If the command line has package names (option '-a' used), or the packages are not known to *apt-get* (new packages), this test is skipped, otherwise it is performed automatically.
+. A simple install-upgrade-purge test within one Debian distribution. This test is like the install-purge test, but install the packages first via *apt-get* and then from the package files given on the command line. If the command line has package names (option '--apt' used), or no tested package is known to *apt-get* (new packages), this test is skipped, otherwise it is performed automatically.
 
 . An upgrade test between Debian releases. This test is enabled by using the '-d' option multiple times and disables the other two tests. It sets up the chroot with the first distribution named, then upgrades it to each successive one, and then remembers the directory tree state at the end. After this, it starts over with the chroot of the first distribution, installs the desired packages (via *apt-get*), and does the successive upgrading (via *apt-get dist-upgrade*). Then, if package files (and not just package names) were given on the command line, it installs them. Finally, it reports problems against the state of the directory tree at the last distribution compared with the state without the packages having been installed. This test can be quite slow to execute.
 +
@@ -63,10 +63,10 @@ The tarball can be created with the '-s' option, or you can use one that *pbuild
   Make dpkg use --force-confdef, which lets dpkg always choose the default action when a modified conffile is found. This option will make piuparts ignore errors it was designed to report and therefore should only be used to hide problems in depending packages. 'This option shall normally not be used.' (See #466118.)
 
 *--dpkg-noforce-unsafe-io*::
-  Prevent running dpkg with --force-unsafe-io.  --force-unsafe-io causes dpkg to skip certain file system syncs known to cause substantial performance degradation on some filesystems.  Thus, including this option reverts to safe but slower behavior.
+  Prevent running dpkg with --force-unsafe-io.  --force-unsafe-io causes dpkg to skip certain file system syncs known to cause substantial performance degradation on some filesystems.  Thus, including this option reverts to safe but slower behavior.  The --dpkg-noforce-unsafe-io is required for running tests on distributions older than squeeze.
 
 *--no-eatmydata*::
-  Prevent use of eatmydata.
+  Prevent use of eatmydata.  The --no-eatmydata option is required for running tests on squeeze or older distributions.
 
 *--extra-old-packages*='pkg1[,pkg2]...'::
   Install additional old packages before upgrading.  Allows testing package renames/merges where the old package is no longer available in the new distribution and the new one utilizes Conflicts/Replaces.  The argument is a comma separated list of package names and the option can be given multiple times.
@@ -104,7 +104,7 @@ The tarball can be created with the '-s' option, or you can use one that *pbuild
   snapshot (default: 1G)
 
 *-l* 'filename', *--log-file*='filename'::
-  Write log file to _filename_ in addition to the standard output.
+  Append log file to _filename_ in addition to the standard output.
 
 *--log-level*='level'::
   Display messages from loglevel LEVEL, possible values are: error, info, dump, debug. The default is dump.
@@ -172,6 +172,8 @@ Note that file: addresses works if the directories are made accessible from with
 
 *-t directory, --tmpdir*='directory'::
   Use directory as the place where temporary files and directories are created. The default is the environment variable *TMPDIR*, or _/tmp_ if not set.
++
+Note: the temporary directory must *not* be mounted with the _nodev_ or _nosuid_ mount option.
 
 *-v, --verbose*::
   This option no longer has any meaning, but it is still accepted for backwards compatibility.
@@ -240,5 +242,5 @@ Lars Wirzenius (liw at iki.fi) and others
 
 DATE
 ----
-2011-12-06
+2012-06-22
 

-- 
piuparts git repository

