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                  [-e num files(entries)] [-O socket_options]
12                  [-m maximum_protocol] [-L] [-c CLIENT.TXT] [-t timelimit]
13                  [-C filename] [-A] [-p port] [-s seed] [-f max_failures]
14                  [-X] {BINDING-STRING|UNC} {TEST1} [TEST2] [...]
15

DESCRIPTION

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

OPTIONS

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

VERSION

164       This man page is correct for version 4.0 of the Samba suite.
165

AUTHOR

170       This utility is part of the Samba[1] suite, which is developed by the
171       global Samba Team[2].
172
173       smbtorture was written by Andrew Tridgell.
174
175       This manpage was written by Jelmer Vernooij.
176

NOTES

178        1. Samba
179           http://www.samba.org/
180
181        2. Samba Team
182           http://www.samba.org/samba/team/
183
184
185
186Samba 4.0                         01/26/2023                     SMBTORTURE(1)