File: README

package info (click to toggle)
ucf 3.0052
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,204 kB
  • sloc: sh: 1,384; perl: 397; makefile: 31
file content (26 lines) | stat: -rw-r--r-- 1,170 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Testsuite for ucf
=================

The testsuite is run with ./run. It utilises unshare(1) to establish a separate
mount namespace for each test; /var/cache/debconf, /var/lib/ucf and
$UCF_TEST_TARGET are each mounted as a tmpfs. This prevents the tests from
interfering with the host system whilst not requiring elevated privileges.  If
the call to unshare(1) fails, the test is skipped with a warning.

Each test is contained in a separate subdirectory. The files in each test
directory are:-

 - test			an executable that runs the test. Installations and
   			filesystem modifications by ucf and friends should be made
			beneath the $UCF_TEST_TARGET directory.

 - expected/output	the expected stdout of `test`.

 - expected/target	the expected contents of $UCF_TEST_TARGET after the script is run.

 - expected/state	the expected contents of /var/lib/ucf after the script has run.

By default, the tests are run using the scripts in the source root
directory. This can be overridden with the UCF_TEST_BINDIR environment
variable. Ensure it ends with a path separator ('/'). If the variable is set to
null (UCF_TEST_BINDIR=), the scripts will be searched in PATH.