From cbffab246997fb5a06211dfb706b54e5ae5bb59f Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:58:51 +0200 Subject: Adding upstream version 1.21.22. Signed-off-by: Daniel Baumann --- tests/README | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 tests/README (limited to 'tests/README') diff --git a/tests/README b/tests/README new file mode 100644 index 0000000..fb7d0a8 --- /dev/null +++ b/tests/README @@ -0,0 +1,55 @@ +dpkg functional test-suite +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +How to run +---------- + +There's a brief usage information when invoking “make” on the topdir. + +You probably want to use something like eatmydata to run the tests, it +affects the performance significantly. + +To use the tools from the dpkg build-tree, set DPKG_BUILDTREE accordingly. + +The DPKG_TESTSUITE_OPTIONS environment/make variable can be used to change +the behaviour of the test runs, the following options are currently +supported: + +* as-root + + WARNING: This runs the tests in privileged mode, and will write to your + current root filesystem. If you are uncertain of the consequences, run + it at least on a chroot, or isolated in a virtual machine. + +* test-all + + This runs all tests, including manual and failing ones. + +* debug + + This makes dpkg print lots of debug output. + +The configuration file ‘.pkg-tests.conf’ can be used to set permanent +parameters. For example: + + ,-- .pkg-tests.conf -- + |DPKG_TESTSUITE_OPTIONS := debug + `-- + +Test-suite layout +----------------- + +The tests are split into logical units, testing a specific characteristic. +To add a new test please check Test.mk and Makefile on the topdir, and some +of the current tests. Patches welcome! + +Future plans +------------ + +There's lots of tests that are still missing, we are adding new ones when +we stumble over regressions, when adding new functionality, and as time +permits for existing functionality. + +The idea is for this to progressively be integrated into the autotools +autotest suite under src/at/, and be run as part of “make check”. Some +changes to dpkg would need to be implemented first. -- cgit v1.2.3