Imported Upstream version 2.22upstream/2.22upstream

1 files changed, 44 insertions, 0 deletions

diff --git a/Documentation/howto-tests.txt b/Documentation/howto-tests.txt
new file mode 100644
index 0000000..fe91024
--- /dev/null
+++ b/Documentation/howto-tests.txt
@@ -0,0 +1,44 @@
+
+ util-linux regression tests
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ It's expected that for each invasive change or important bugfix you will
+ include a test to your patch.
+
+ Compile tests & run basic tests:
+
+	$ make check
+
+ Note that the configure option --disable-static disables many of libmount and
+ libblkid unit tests.
+
+ Run all tests including tests that require root permissions:
+
+	# cd tests
+	# ./run.sh [--verbose] [--memcheck]
+
+ note that as root you have to manually remove output and diff directories
+
+	# rm -rf output diff
+
+ or run 'make clean' as root.
+
+
+ Run subset of tests:
+
+	$ ./run.sh <test_directory-name>
+
+        for example:
+
+              $ ./run.sh blkid
+              $ ./run.sh libmount
+
+
+
+ *** WARNING for root users ***
+
+ The tests touch your /etc/fstab, initialize loop devices or scsi_debug devices
+ if executed with root permissions.
+
+ Please, be careful and use these tests only for development and never on
+ production system.