From 93b80f1ceb1efffd16a489bebd63ec10dd947989 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sat, 5 Jan 2008 19:33:05 -0600 Subject: [PATCH] r26673: selftest: Document the purpose and output format of samba4_tests.sh. --- source/selftest/samba4_tests.sh | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/source/selftest/samba4_tests.sh b/source/selftest/samba4_tests.sh index 66717c03ae..290c06fa6a 100755 --- a/source/selftest/samba4_tests.sh +++ b/source/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 -- 2.34.1