svn commit: samba r24893 - in branches/SAMBA_4_0: . source/selftest

[jelmer at samba.org]

Author: jelmer
Date: 2007-09-02 13:32:52 +0000 (Sun, 02 Sep 2007)
New Revision: 24893

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=24893

Log:
Update documentation for selftest.
Modified:
   branches/SAMBA_4_0/
   branches/SAMBA_4_0/source/selftest/README
   branches/SAMBA_4_0/source/selftest/TODO
   branches/SAMBA_4_0/source/selftest/selftest.pl


Changeset:

Property changes on: branches/SAMBA_4_0
___________________________________________________________________
Name: bzr:revision-info
...skipped...
Name: bzr:revision-id:v3-trunk0
...skipped...

Modified: branches/SAMBA_4_0/source/selftest/README
===================================================================
--- branches/SAMBA_4_0/source/selftest/README	2007-09-02 13:30:28 UTC (rev 24892)
+++ branches/SAMBA_4_0/source/selftest/README	2007-09-02 13:32:52 UTC (rev 24893)
@@ -3,18 +3,22 @@
 
 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

Modified: branches/SAMBA_4_0/source/selftest/TODO
===================================================================
--- branches/SAMBA_4_0/source/selftest/TODO	2007-09-02 13:30:28 UTC (rev 24892)
+++ branches/SAMBA_4_0/source/selftest/TODO	2007-09-02 13:32:52 UTC (rev 24893)
@@ -1,3 +1,2 @@
 - warn about unexpected successes
 - better way to detect that smbd has finished initialization
-- move ldap-specific code into mktestdc.sh

Modified: branches/SAMBA_4_0/source/selftest/selftest.pl
===================================================================
--- branches/SAMBA_4_0/source/selftest/selftest.pl	2007-09-02 13:30:28 UTC (rev 24892)
+++ branches/SAMBA_4_0/source/selftest/selftest.pl	2007-09-02 13:32:52 UTC (rev 24893)
@@ -13,7 +13,7 @@
 
 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 @@
 
 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