Fix and test python scripts and kerberos
[samba.git] / source4 / selftest / README
1 # vim: ft=rst
2
3 This directory contains test scripts that are useful for running a
4 bunch of tests all at once. 
5
6 ===============
7 Available tests
8 ===============
9 The available tests are obtained from a script, usually 
10 selftest/samba{3,4}_tests.sh. This script should for each test output 
11 the name of the test, the command to run and the environment that should be 
12 provided.
13
14 ============
15 Environments
16 ============
17 Tests often need to run against a server with particular things set up, 
18 a "environment". This environment is provided by the test "target": Samba 3, 
19 Samba 4 or Windows.
20
21 The following environments are currently available:
22
23  - none: No server set up, no variables set.
24  - dc: Domain controller set up. The following environment variables will 
25    be set:
26      * USERNAME: Administrator user name
27          * PASSWORD: Administrator password
28          * DOMAIN: Domain name
29          * REALM: Realm name
30          * SERVER: DC host name 
31          * SERVER_IP: DC IPv4 address
32          * NETBIOSNAME: DC NetBIOS name
33          * NETIOSALIAS: DC NetBIOS alias
34
35  - member: Domain controller and member server that is joined to it set up. The
36    following environment variables will be set:
37      * USERNAME: Domain administrator user name
38          * PASSWORD: Domain administrator password
39          * DOMAIN: Domain name
40          * REALM: Realm name
41          * SERVER: Name of the member server
42
43
44 =============
45 Running tests
46 =============
47
48 To run all the tests use:
49
50    make test
51
52 To run a quick subset (aiming for about 1 minute of testing) run:
53
54    make quicktest
55
56 To run a specific test, use this syntax
57
58    make test TESTS=testname
59
60 for example
61
62    make test TESTS=samba4.BASE-DELETE