1<?xml version="1.0" encoding="iso-8859-1"?> 2<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc"> 3<refentry id="smbtorture.1"> 4 5<refmeta> 6 <refentrytitle>smbtorture</refentrytitle> 7 <manvolnum>1</manvolnum> 8</refmeta> 9 10 11<refnamediv> 12 <refname>smbtorture</refname> 13 <refpurpose>Run a series of tests against a SMB server</refpurpose> 14</refnamediv> 15 16<refsynopsisdiv> 17 <cmdsynopsis> 18 <command>smbtorture</command> 19 </cmdsynopsis> 20 21 <cmdsynopsis> 22 <command>smbtorture</command> 23 <arg choice="req">//server/share</arg> 24 <arg choice="opt">-d debuglevel</arg> 25 <arg choice="opt">-U user%pass</arg> 26 <arg choice="opt">-k</arg> 27 <arg choice="opt">-N numprocs</arg> 28 <arg choice="opt">-n netbios_name</arg> 29 <arg choice="opt">-W workgroup</arg> 30 <arg choice="opt">-o num_operations</arg> 31 <arg choice="opt">-e num files(entries)</arg> 32 <arg choice="opt">-O socket_options</arg> 33 <arg choice="opt">-m maximum_protocol</arg> 34 <arg choice="opt">-L</arg> 35 <arg choice="opt">-c CLIENT.TXT</arg> 36 <arg choice="opt">-t timelimit</arg> 37 <arg choice="opt">-C filename</arg> 38 <arg choice="opt">-A</arg> 39 <arg choice="opt">-p port</arg> 40 <arg choice="opt">-s seed</arg> 41 <arg choice="opt">-f max_failures</arg> 42 <arg choice="opt">-X</arg> 43 <arg choice="req">BINDING-STRING|UNC</arg> 44 <arg choice="req">TEST1</arg> 45 <arg choice="opt">TEST2</arg> 46 <arg choice="opt">...</arg> 47 </cmdsynopsis> 48 49</refsynopsisdiv> 50 51<refsect1> 52 <title>DESCRIPTION</title> 53 54 <para>smbtorture is a testsuite that runs several tests 55 against a SMB server. All tests are known to succeed 56 against a Windows 2003 server (?). Smbtorture's primary 57 goal is finding differences in implementations of the SMB protocol 58 and testing SMB servers. 59 </para> 60 61 <para>Any number of tests can be specified 62 on the command-line. If no tests are specified, all tests 63 are run. </para> 64 65 <para>If no arguments are specified at all, all available options 66 and tests are listed.</para> 67 68 <refsect2> 69 <title>Binding string format</title> 70 71 <para>The binding string format is:</para> 72 73 <para>TRANSPORT:host[flags]</para> 74 75 <para>Where TRANSPORT is either ncacn_np for SMB, ncacn_ip_tcp for RPC/TCP or ncalrpc for local connections. 76 </para> 77 78 <para> 79 'host' is an IP or hostname or netbios name. If the binding string 80 identifies the server side of an endpoint, 'host' may be an empty 81 string. 82 </para> 83 84 <para> 85 'flags' can include a SMB pipe name if using the ncacn_np transport or 86 a TCP port number if using the ncacn_ip_tcp transport, otherwise they 87 will be auto-determined. 88 </para> 89 90 <para> 91 other recognised flags are: 92 </para> 93 94 <variablelist> 95 <varlistentry><term>sign</term> 96 <listitem><para>enable ntlmssp signing</para></listitem> 97 </varlistentry> 98 99 <varlistentry><term>seal</term> 100 <listitem><para>enable ntlmssp sealing</para></listitem> 101 </varlistentry> 102 103 <varlistentry><term>connect</term> 104 <listitem><para>enable rpc connect level auth (auth, but no sign or seal)</para></listitem> 105 </varlistentry> 106 107 <varlistentry><term>validate</term> 108 <listitem><para>enable the NDR validator</para></listitem> 109 </varlistentry> 110 111 <varlistentry><term>print</term> 112 <listitem><para>enable debugging of the packets</para></listitem> 113 </varlistentry> 114 115 <varlistentry><term>bigendian</term> 116 <listitem><para>use bigendian RPC</para></listitem> 117 </varlistentry> 118 119 <varlistentry><term>padcheck</term> 120 <listitem><para>check reply data for non-zero pad bytes</para></listitem> 121 </varlistentry> 122 </variablelist> 123 124 <para>For example, these all connect to the samr pipe:</para> 125 126 <itemizedlist> 127 <listitem><para>ncacn_np:myserver</para></listitem> 128 <listitem><para>ncacn_np:myserver[samr]</para></listitem> 129 <listitem><para>ncacn_np:myserver[\\pipe\\samr]</para></listitem> 130 <listitem><para>ncacn_np:myserver[/pipe/samr]</para></listitem> 131 <listitem><para>ncacn_np:myserver[samr,sign,print]</para></listitem> 132 <listitem><para>ncacn_np:myserver[\\pipe\\samr,sign,seal,bigendian]</para></listitem> 133 <listitem><para>ncacn_np:myserver[/pipe/samr,seal,validate]</para></listitem> 134 <listitem><para>ncacn_np:</para></listitem> 135 <listitem><para>ncacn_np:[/pipe/samr]</para></listitem> 136 <listitem><para>ncacn_ip_tcp:myserver</para></listitem> 137 <listitem><para>ncacn_ip_tcp:myserver[1024]</para></listitem> 138 <listitem><para>ncacn_ip_tcp:myserver[1024,sign,seal]</para></listitem> 139 <listitem><para>ncalrpc:</para></listitem> 140 </itemizedlist> 141 142 </refsect2> 143 144 <refsect2> 145 <title>UNC Format</title> 146 147 <para>The UNC format is:</para> 148 149 <para>//server/share</para> 150 </refsect2> 151 152</refsect1> 153 154 155<refsect1> 156 <title>OPTIONS</title> 157 158 <variablelist> 159 <varlistentry><term>-d debuglevel</term> 160 <listitem><para>Use the specified Samba debug level. A higher debug level 161 means more output.</para></listitem> 162 </varlistentry> 163 <varlistentry><term>-U user%pass</term> 164 <listitem><para>Use the specified username/password combination when logging in to a remote server.</para></listitem> 165 </varlistentry> 166 <varlistentry><term>-k</term> 167 <listitem><para>Use kerberos when authenticating.</para></listitem> 168 </varlistentry> 169 <varlistentry><term>-W workgroup</term> 170 <listitem><para>Use specified name as our workgroup name.</para></listitem> 171 </varlistentry> 172 <varlistentry><term>-n netbios_name</term> 173 <listitem><para>Use specified name as our NetBIOS name.</para></listitem> 174 </varlistentry> 175 176 <varlistentry><term>-O socket_options</term> 177 <listitem><para>Use specified socket options, equivalent of the smb.conf option <quote>socket options</quote>. See the smb.conf(5) manpage for details.</para></listitem> 178 </varlistentry> 179 180 <varlistentry><term>-m max_protocol</term> 181 <listitem><para>Specify the maximum SMB dialect that should be used. Possible values are: CORE, COREPLUS, LANMAN1, LANMAN2, NT1</para></listitem> 182 </varlistentry> 183 184 <varlistentry><term>-s seed</term> 185 <listitem><para>Initialize the randomizer using <replaceable>seed</replaceable> as seed.</para></listitem> 186 </varlistentry> 187 188 <varlistentry><term>-L</term> 189 <listitem><para>Use oplocks.</para></listitem> 190 </varlistentry> 191 192 <varlistentry><term>-X</term> 193 <listitem><para>Enable dangerous tests. Use with care! This might crash your server...</para></listitem> 194 </varlistentry> 195 196 <varlistentry><term>-t timelimit</term> 197 <listitem><para>Specify the NBENCH time limit in seconds. Defaults to 600.</para></listitem> 198 </varlistentry> 199 200 <varlistentry><term>-p ports</term> 201 <listitem><para>Specify ports to connect to.</para></listitem> 202 </varlistentry> 203 204 <varlistentry><term>-c file</term> 205 <listitem><para>Read NBENCH commands from <replaceable>file</replaceable> instead of from CLIENT.TXT.</para></listitem> 206 </varlistentry> 207 208 <varlistentry><term>-A</term> 209 <listitem><para>Show not just OK or FAILED but more detailed 210 output. Used only by DENY test at the moment.</para></listitem> 211 </varlistentry> 212 213 <varlistentry><term>-C filename</term> 214 <listitem><para>Load a list of UNC names from the specified filename. Smbtorture instances will connect to a random host from this list.</para></listitem> 215 </varlistentry> 216 217 <varlistentry><term>-N numprocs</term> 218 <listitem><para>Specify number of smbtorture processes to launch.</para></listitem> 219 </varlistentry> 220 221 <varlistentry><term>-o num_operations</term> 222 <listitem><para>Number of times some operations should be tried before assuming they're output is consistent (default:100).</para></listitem> 223 </varlistentry> 224 225 <varlistentry><term>-e num_files</term> 226 <listitem><para>Number of entries to use in certain tests (such as creating X files) (default: 1000).</para></listitem> 227 </varlistentry> 228 229 <varlistentry><term>-f max_failures</term> 230 <listitem><para>Number of failures before aborting a test (default: 1).</para></listitem> 231 </varlistentry> 232 </variablelist> 233</refsect1> 234 235<refsect1> 236 <title>VERSION</title> 237 238 <para>This man page is correct for version 4.0 of the Samba suite.</para> 239</refsect1> 240 241<refsect1> 242 <title>SEE ALSO</title> 243 244 <para>Samba</para> 245 246</refsect1> 247 248<refsect1> 249 <title>AUTHOR</title> 250 251 <para>This utility is part of the <ulink url="http://www.samba.org/">Samba</ulink> suite, which is developed by the global <ulink url="http://www.samba.org/samba/team/">Samba Team</ulink>.</para> 252 253 <para>smbtorture was written by Andrew Tridgell.</para> 254 255 <para>This manpage was written by Jelmer Vernooij.</para> 256 257</refsect1> 258 259</refentry> 260