summaryrefslogtreecommitdiff
path: root/selftest/selftest.pl.1
blob: f33b81044e9489202d3aa8a5b67ce15d1c659a3c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
.IX Title "SELFTEST 1"
.TH SELFTEST 1 "2012-02-24" "selftest" "Samba"
.if n .ad l
.nh
.SH "NAME"
selftest \- Samba test runner
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
selftest \-\-help
.PP
selftest [\-\-srcdir=DIR] [\-\-bindir=DIR] [\-\-target=samba|samba3|win] [\-\-socket\-wrapper] [\-\-quick] [\-\-exclude=FILE] [\-\-include=FILE] [\-\-one] [\-\-prefix=prefix] [\-\-testlist=FILE] [\s-1TESTS\s0]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
A simple test runner. \s-1TESTS\s0 is a regular expression with tests to run.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fI\-\-help\fR" 4
.IX Item "--help"
Show list of available options.
.IP "\fI\-\-srcdir=DIR\fR" 4
.IX Item "--srcdir=DIR"
Source directory.
.IP "\fI\-\-bindir=DIR\fR" 4
.IX Item "--bindir=DIR"
Built binaries directory.
.IP "\fI\-\-prefix=DIR\fR" 4
.IX Item "--prefix=DIR"
Change directory to run tests in. Default is 'st'.
.IP "\fI\-\-target samba|samba3|win\fR" 4
.IX Item "--target samba|samba3|win"
Specify test target against which to run. Default is 'samba4'.
.IP "\fI\-\-quick\fR" 4
.IX Item "--quick"
Run only a limited number of tests. Intended to run in about 30 seconds on 
moderately recent systems.
.IP "\fI\-\-socket\-wrapper\fR" 4
.IX Item "--socket-wrapper"
Use socket wrapper library for communication with server. Only works 
when the server is running locally.
.Sp
Will prevent \s-1TCP\s0 and \s-1UDP\s0 ports being opened on the local host but 
(transparently) redirects these calls to use unix domain sockets.
.IP "\fI\-\-exclude\fR" 4
.IX Item "--exclude"
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.
.IP "\fI\-\-include\fR" 4
.IX Item "--include"
Specify a file containing a list of tests that should be run. Same format 
as the \-\-exclude flag.
.Sp
Not includes specified means all tests will be run.
.IP "\fI\-\-one\fR" 4
.IX Item "--one"
Abort as soon as one test fails.
.IP "\fI\-\-testlist\fR" 4
.IX Item "--testlist"
Load a list of tests from the specified location.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.IP "\fI\s-1SMBD_VALGRIND\s0\fR" 4
.IX Item "SMBD_VALGRIND"
.PD 0
.IP "\fI\s-1TORTURE_MAXTIME\s0\fR" 4
.IX Item "TORTURE_MAXTIME"
.IP "\fI\s-1VALGRIND\s0\fR" 4
.IX Item "VALGRIND"
.IP "\fI\s-1TLS_ENABLED\s0\fR" 4
.IX Item "TLS_ENABLED"
.IP "\fIsrcdir\fR" 4
.IX Item "srcdir"
.PD
.SH "LICENSE"
.IX Header "LICENSE"
selftest is licensed under the \s-1GNU\s0 General Public License <http://www.gnu.org/licenses/gpl.html>.
.SH "AUTHOR"
.IX Header "AUTHOR"
Pidl was written by Jelmer Vernooij.