diff options
author | Jelmer Vernooij <jelmer@samba.org> | 2015-01-21 02:58:45 +0100 |
---|---|---|
committer | Andreas Schneider <asn@cryptomilk.org> | 2015-02-17 15:41:10 +0100 |
commit | f1f49e807c4b7f33cba2db4007e9445da2168cb4 (patch) | |
tree | a220333032fff10101397b515ce7c564e831fd12 /selftest/README | |
parent | bcbdc74b2618bdddb920feecf3e8bd7d11f12441 (diff) | |
download | samba-f1f49e807c4b7f33cba2db4007e9445da2168cb4.tar.gz |
Update selftest README to point at upstream subunit repository for protocol description.
Change-Id: I50c2a5e9847d269486cb5157357592004779704a
Signed-Off-By: Jelmer Vernooij <jelmer@samba.org>
Reviewed-by: Andreas Schneider <asn@samba.org>
Diffstat (limited to 'selftest/README')
-rw-r--r-- | selftest/README | 33 |
1 files changed, 17 insertions, 16 deletions
diff --git a/selftest/README b/selftest/README index d9ad0202683..012a5cb2999 100644 --- a/selftest/README +++ b/selftest/README @@ -1,22 +1,22 @@ # vim: ft=rst This directory contains test scripts that are useful for running a -bunch of tests all at once. +bunch of tests all at once. -There are two parts to this: +There are two parts to this: * The test runner (selftest/selftest.pl) * The test formatter -selftest.pl simply outputs subunit, which can then be formatted or analyzed -by tools that understand the subunit protocol. One of these tools is +selftest.pl simply outputs subunit, which can then be formatted or analyzed +by tools that understand the subunit protocol. One of these tools is format-subunit, which is used by default as part of "make test". Available testsuites ==================== -The available testsuites are obtained from a script, usually +The available testsuites are obtained from a script, usually source{3,4}/selftest/tests.py. This script should for each testsuite output -the name of the test, the command to run and the environment that should be +the name of the test, the command to run and the environment that should be provided. Use the included "plantest" function to generate the required output. Testsuite behaviour @@ -24,20 +24,21 @@ Testsuite behaviour Exit code ------------ -The testsuites should exit with a non-zero exit code if at least one +The testsuites should exit with a non-zero exit code if at least one test failed. Skipped tests should not influence the exit code. Output format ------------- -Testsuites can simply use the exit code to indicate whether all of their -tests have succeeded or one or more have failed. It is also possible to -provide more granular information using the Subunit protocol. +Testsuites can simply use the exit code to indicate whether all of their +tests have succeeded or one or more have failed. It is also possible to +provide more granular information using the Subunit protocol. -This protocol works by writing simple messages to standard output. Any -messages that can not be interpreted by this protocol are considered comments +This protocol works by writing simple messages to standard output. Any +messages that can not be interpreted by this protocol are considered comments for the last announced test. -For a full description of the subunit protocol, see ../lib/subunit/README. +For a full description of the subunit protocol, see the README file in the subunit +repository at http://github.com/testing-cabal/subunit. The following commands are Samba extensions to Subunit: @@ -73,8 +74,8 @@ Indicate that a testsuite has failed. Environments ============ -Tests often need to run against a server with particular things set up, -a "environment". This environment is provided by the test "target": Samba 3, +Tests often need to run against a server with particular things set up, +a "environment". This environment is provided by the test "target": Samba 3, Samba 4 or Windows. The environments are currently available include @@ -87,7 +88,7 @@ The environments are currently available include * PASSWORD: Administrator password * DOMAIN: Domain name * REALM: Realm name - * SERVER: DC host name + * SERVER: DC host name * SERVER_IP: DC IPv4 address * SERVER_IPV6: DC IPv6 address * NETBIOSNAME: DC NetBIOS name |