summaryrefslogtreecommitdiff
path: root/source4
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2007-09-02 13:32:52 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 15:03:31 -0500
commitf1e576cb1232bd855a7645bce40c0afc86900cba (patch)
treeafdc46062075c712e75b023e9bd1c19b75d9455e /source4
parent0cbb232fac540a5b731e8a25bbf45ff6c4c37d90 (diff)
downloadsamba-f1e576cb1232bd855a7645bce40c0afc86900cba.tar.gz
samba-f1e576cb1232bd855a7645bce40c0afc86900cba.tar.bz2
samba-f1e576cb1232bd855a7645bce40c0afc86900cba.zip
r24893: Update documentation for selftest.
(This used to be commit df8f0677f398b26a2764be74715294bb76b1c248)
Diffstat (limited to 'source4')
-rw-r--r--source4/selftest/README26
-rw-r--r--source4/selftest/TODO1
-rwxr-xr-xsource4/selftest/selftest.pl12
3 files changed, 25 insertions, 14 deletions
diff --git a/source4/selftest/README b/source4/selftest/README
index 1d67a6d85d..a0afda3d19 100644
--- a/source4/selftest/README
+++ b/source4/selftest/README
@@ -3,18 +3,22 @@ bunch of tests all at once.
The following environments are currently available:
- - none: No server set up
+ - none: No server set up, no variables set.
- dc: Domain controller set up. The following environment variables will
be set:
- * USERNAME
- * PASSWORD
- * DOMAIN
- * REALM
- * SERVER
+ * USERNAME: Administrator user name
+ * PASSWORD: Administrator password
+ * DOMAIN: Domain name
+ * REALM: Realm name
+ * SERVER: DC host name
+ * SERVER_IP: DC IPv4 address
+ * NETBIOSNAME: DC NetBIOS name
+ * NETIOSALIAS: DC NetBIOS alias
+
- member: Domain controller and member server that is joined to it set up. The
following environment variables will be set:
- * USERNAME
- * PASSWORD
- * DOMAIN
- * REALM
- * SERVER (contains the name of the member server)
+ * USERNAME: Domain administrator user name
+ * PASSWORD: Domain administrator password
+ * DOMAIN: Domain name
+ * REALM: Realm name
+ * SERVER: Name of the member server
diff --git a/source4/selftest/TODO b/source4/selftest/TODO
index 42f90188ed..67776ffc76 100644
--- a/source4/selftest/TODO
+++ b/source4/selftest/TODO
@@ -1,3 +1,2 @@
- warn about unexpected successes
- better way to detect that smbd has finished initialization
-- move ldap-specific code into mktestdc.sh
diff --git a/source4/selftest/selftest.pl b/source4/selftest/selftest.pl
index db5bd2cf27..03247a4f81 100755
--- a/source4/selftest/selftest.pl
+++ b/source4/selftest/selftest.pl
@@ -13,7 +13,7 @@ selftest - Samba test runner
selftest --help
-selftest [--srcdir=DIR] [--builddir=DIR] [--target=samba4|samba3|win] [--socket-wrapper] [--quick] [--one] [--prefix=prefix] [--immediate] [TESTS]
+selftest [--srcdir=DIR] [--builddir=DIR] [--target=samba4|samba3|win] [--socket-wrapper] [--quick] [--one] [--prefix=prefix] [--immediate] [--testlist=FILE] [TESTS]
=head1 DESCRIPTION
@@ -69,15 +69,23 @@ The format for the file is, one entry per line:
TESTSUITE-NAME/TEST-NAME
+The reason for a test can also be specified, by adding a hash sign (#) and the reason
+after the test name.
+
=item I<--skip>
Specify a file containing a list of tests that should be skipped. Possible candidates are
-tests that segfault the server, flip or don't end.
+tests that segfault the server, flip or don't end. The format of this file is the same as
+for the --expected-failures flag.
=item I<--one>
Abort as soon as one test fails.
+=item I<--testlist>
+
+Load a list of tests from the specified location.
+
=back
=head1 ENVIRONMENT