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