aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2016-06-22 22:53:42 +0200
committerLudovic Courtès <ludo@gnu.org>2016-06-22 22:56:06 +0200
commit0a2f2848d5f39e008397215e697e14335dcce7c1 (patch)
tree18736abe04afd6ea55cd9770cfc3198ebc51bfe0
parentc311089b0b19f094e44d3f858c29f77d757332d1 (diff)
downloadguix-0a2f2848d5f39e008397215e697e14335dcce7c1.tar
guix-0a2f2848d5f39e008397215e697e14335dcce7c1.tar.gz
doc: Document 'make check-system'.
* doc/guix.texi (Running the Test Suite): Document 'make check-system'.
-rw-r--r--doc/guix.texi25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 7516d75b8d..d6d16b4d45 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -620,6 +620,31 @@ Upon failure, please email @email{bug-guix@@gnu.org} and attach the
as well as version numbers of the dependencies (@pxref{Requirements}) in
your message.
+Guix also comes with a whole-system test suite that tests complete
+GuixSD operating system instances. It can only run on systems where
+Guix is already installed, using:
+
+@example
+make check-system
+@end example
+
+@noindent
+or, again, by defining @code{TESTS} to select a subset of tests to run:
+
+@example
+make check-system TESTS="basic mcron"
+@end example
+
+These system tests are defined in the @code{(gnu tests @dots{})}
+modules. They work by running the operating systems under test with
+lightweight instrumentation in a virtual machine (VM). They can be
+computationally intensive or rather cheap, depending on whether
+substitutes are available for their dependencies (@pxref{Substitutes}).
+Some of them require a lot of storage space to hold VM images.
+
+Again in case of test failures, please send @email{bug-guix@@gnu.org}
+all the details.
+
@node Setting Up the Daemon
@section Setting Up the Daemon