summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2008-01-05 19:33:05 -0600
committerStefan Metzmacher <metze@samba.org>2008-01-05 13:36:01 -0600
commit58788694cd86bbd0e16d63336880c54c0ef2e88d (patch)
treed09b885f0c9e081d0176e5158230cf981bd69dfc
parentdf408d056ec03f2abe08ce0ea487e1875b90e7bf (diff)
downloadsamba-58788694cd86bbd0e16d63336880c54c0ef2e88d.tar.gz
samba-58788694cd86bbd0e16d63336880c54c0ef2e88d.tar.bz2
samba-58788694cd86bbd0e16d63336880c54c0ef2e88d.zip
r26673: selftest: Document the purpose and output format of samba4_tests.sh.
(This used to be commit 93b80f1ceb1efffd16a489bebd63ec10dd947989)
-rwxr-xr-xsource4/selftest/samba4_tests.sh19
1 files changed, 19 insertions, 0 deletions
diff --git a/source4/selftest/samba4_tests.sh b/source4/selftest/samba4_tests.sh
index 66717c03ae..290c06fa6a 100755
--- a/source4/selftest/samba4_tests.sh
+++ b/source4/selftest/samba4_tests.sh
@@ -1,4 +1,23 @@
#!/bin/sh
+# This script generates a list of testsuites that should be run as part of
+# the Samba 4 test suite.
+
+# The output of this script is parsed by selftest.pl, which then decides
+# which of the tests to actually run. It will, for example, skip all tests
+# listed in samba4-skip or only run a subset during "make quicktest".
+
+# The idea is that this script outputs all of the tests of Samba 4, not
+# just those that are known to pass, and list those that should be skipped
+# or are known to file in samba4-skip/samba4-knownfail. This makes it
+# very easy to see what functionality is still missing in Samba 4 and makes
+# it possible to run the testsuite against other servers, such as Samba 3 or
+# Windows that have a different set of features.
+
+# The syntax for a testsuite is "-- TEST --" on a single line, followed
+# by the name of the test, the environment it needs and the command to run, all
+# three separated by newlines. All other lines in the output are considered
+# comments.
+
if [ ! -n "$PERL" ]
then
PERL=perl