r24893: Update documentation for selftest.
authorJelmer Vernooij <jelmer@samba.org>
Sun, 2 Sep 2007 13:32:52 +0000 (13:32 +0000)
committerGerald (Jerry) Carter <jerry@samba.org>
Wed, 10 Oct 2007 20:03:31 +0000 (15:03 -0500)
(This used to be commit df8f0677f398b26a2764be74715294bb76b1c248)

source4/selftest/README
source4/selftest/TODO
source4/selftest/selftest.pl

index 1d67a6d85d2a9f39c3e1be4c680bb5032233014c..a0afda3d1966744d8aeee48bedcf9334a23750c6 100644 (file)
@@ -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
index 42f90188ed82808da3f7e1a47912da680ba84382..67776ffc766f7bbe5ca4162f97db7215d2edaa94 100644 (file)
@@ -1,3 +1,2 @@
 - warn about unexpected successes
 - better way to detect that smbd has finished initialization
-- move ldap-specific code into mktestdc.sh
index db5bd2cf27c754d1bf650e0325fb45c3114e3b93..03247a4f815c96b92d38c62813c59e115f499108 100755 (executable)
@@ -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