smbtorture(1)

1SMBTORTURE(1)                     Test Suite                     SMBTORTURE(1)
2
3
4

NAME

6       smbtorture - Run a series of tests against a SMB server
7

SYNOPSIS

9       smbtorture {//server/share} [-d debuglevel] [-U user%pass] [-k]
10                  [-N numprocs] [-n netbios_name] [-W workgroup]
11                  [-o num_operations] [-e num files(entries)]
12                  [-O socket_options] [-m maximum_protocol] [-L]
13                  [-c CLIENT.TXT] [-t timelimit] [-C filename] [-A] [-p port]
14                  [-s seed] [-f max_failures] [-X] {BINDING-STRING|UNC}
15                  {TEST1} [TEST2] [...]
16

DESCRIPTION

18       smbtorture is a testsuite that runs several tests against a SMB server.
19       All tests are known to succeed against a Windows 2003 server (?).
20       Smbtorture's primary goal is finding differences in implementations of
21       the SMB protocol and testing SMB servers.
22
23       Any number of tests can be specified on the command-line. If no tests
24       are specified, all tests are run.
25
26       If no arguments are specified at all, all available options and tests
27       are listed.
28
29   Binding string format
30       The binding string format is:
31
32       TRANSPORT:host[flags]
33
34       Where TRANSPORT is either ncacn_np for SMB, ncacn_ip_tcp for RPC/TCP or
35       ncalrpc for local connections.
36
37       'host' is an IP or hostname or netbios name. If the binding string
38       identifies the server side of an endpoint, 'host' may be an empty
39       string.
40
41       'flags' can include a SMB pipe name if using the ncacn_np transport or
42       a TCP port number if using the ncacn_ip_tcp transport, otherwise they
43       will be auto-determined.
44
45       other recognised flags are:
46
47       sign
48           enable ntlmssp signing
49
50       seal
51           enable ntlmssp sealing
52
53       connect
54           enable rpc connect level auth (auth, but no sign or seal)
55
56       validate
57           enable the NDR validator
58
59       print
60           enable debugging of the packets
61
62       bigendian
63           use bigendian RPC
64
65       padcheck
66           check reply data for non-zero pad bytes
67
68       For example, these all connect to the samr pipe:
69
70       ·   ncacn_np:myserver
71
72       ·   ncacn_np:myserver[samr]
73
74       ·   ncacn_np:myserver[\\pipe\\samr]
75
76       ·   ncacn_np:myserver[/pipe/samr]
77
78       ·   ncacn_np:myserver[samr,sign,print]
79
80       ·   ncacn_np:myserver[\\pipe\\samr,sign,seal,bigendian]
81
82       ·   ncacn_np:myserver[/pipe/samr,seal,validate]
83
84       ·   ncacn_np:
85
86       ·   ncacn_np:[/pipe/samr]
87
88       ·   ncacn_ip_tcp:myserver
89
90       ·   ncacn_ip_tcp:myserver[1024]
91
92       ·   ncacn_ip_tcp:myserver[1024,sign,seal]
93
94       ·   ncalrpc:
95
96   UNC Format
97       The UNC format is:
98
99       //server/share
100

OPTIONS

102       -d debuglevel
103           Use the specified Samba debug level. A higher debug level means
104           more output.
105
106       -U user%pass
107           Use the specified username/password combination when logging in to
108           a remote server.
109
110       -k
111           Use kerberos when authenticating.
112
113       -W workgroup
114           Use specified name as our workgroup name.
115
116       -n netbios_name
117           Use specified name as our NetBIOS name.
118
119       -O socket_options
120           Use specified socket options, equivalent of the smb.conf option
121           “socket options”. See the smb.conf(5) manpage for details.
122
123       -m max_protocol
124           Specify the maximum SMB dialect that should be used. Possible
125           values are: CORE, COREPLUS, LANMAN1, LANMAN2, NT1
126
127       -s seed
128           Initialize the randomizer using seed as seed.
129
130       -L
131           Use oplocks.
132
133       -X
134           Enable dangerous tests. Use with care! This might crash your
135           server...
136
137       -t timelimit
138           Specify the NBENCH time limit in seconds. Defaults to 600.
139
140       -p ports
141           Specify ports to connect to.
142
143       -c file
144           Read NBENCH commands from file instead of from CLIENT.TXT.
145
146       -A
147           Show not just OK or FAILED but more detailed output. Used only by
148           DENY test at the moment.
149
150       -C filename
151           Load a list of UNC names from the specified filename. Smbtorture
152           instances will connect to a random host from this list.
153
154       -N numprocs
155           Specify number of smbtorture processes to launch.
156
157       -o num_operations
158           Number of times some operations should be tried before assuming
159           they're output is consistent (default:100).
160
161       -e num_files
162           Number of entries to use in certain tests (such as creating X
163           files) (default: 1000).
164
165       -f max_failures
166           Number of failures before aborting a test (default: 1).
167

VERSION

169       This man page is correct for version 4.0 of the Samba suite.
170

AUTHOR

175       This utility is part of the Samba[1] suite, which is developed by the
176       global Samba Team[2].
177
178       smbtorture was written by Andrew Tridgell.
179
180       This manpage was written by Jelmer Vernooij.
181

NOTES

183        1. Samba
184           http://www.samba.org/
185
186        2. Samba Team
187           http://www.samba.org/samba/team/
188
189
190
191Samba 4.0                         12/16/2019                     SMBTORTURE(1)