source4/torture/man/locktest.1.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   3 <refentry id="locktest.1">
   4
   5 <refmeta>
   6         <refentrytitle>locktest</refentrytitle>
   7         <manvolnum>1</manvolnum>
   8         <refmiscinfo class="source">Samba</refmiscinfo>
   9         <refmiscinfo class="manual">Test Suite</refmiscinfo>
  10         <refmiscinfo class="version">4.0</refmiscinfo>
  11 </refmeta>
  12
  13
  14 <refnamediv>
  15         <refname>locktest</refname>
  16         <refpurpose>Find differences in locking between two SMB servers</refpurpose>
  17 </refnamediv>
  18
  19 <refsynopsisdiv>
  20         <cmdsynopsis>
  21                 <command>locktest</command>
  22                 <arg choice="req">//server1/share1</arg>
  23                 <arg choice="req">//server2/share2</arg>
  24                 <arg choice="opt">-U user%pass</arg>
  25                 <arg choice="opt">-U user%pass</arg>
  26                 <arg choice="opt">-s seed</arg>
  27                 <arg choice="opt">-o numops</arg>
  28                 <arg choice="opt">-a</arg>
  29                 <arg choice="opt">-O</arg>
  30                 <arg choice="opt">-E</arg>
  31                 <arg choice="opt">-Z</arg>
  32                 <arg choice="opt">-R range</arg>
  33                 <arg choice="opt">-B base</arg>
  34                 <arg choice="opt">-M min</arg>
  35         </cmdsynopsis>
  36
  37 </refsynopsisdiv>
  38
  39 <refsect1>
  40         <title>DESCRIPTION</title>
  41
  42         <para><application>locktest</application> is a utility for
  43                 detecting differences in behaviour in locking between SMB servers.
  44                 It will run a random set of locking operations against
  45                 <parameter>//server1/share1</parameter> and then the same
  46                 random set against <parameter>//server2/share2</parameter>
  47                 and display the differences in the responses it gets.
  48         </para>
  49
  50         <para>
  51                 This utility is used by the Samba team to find differences in
  52                 behaviour between Samba and Windows servers.
  53         </para>
  54 </refsect1>
  55
  56
  57 <refsect1>
  58         <title>OPTIONS</title>
  59
  60         <variablelist>
  61                 <varlistentry>
  62                         <term>-U user%pass</term>
  63                         <listitem><para>
  64                                         Specify the user and password to use when logging on
  65                                         on the shares. This parameter can be specified twice
  66                                         (once for the first server, once for the second).
  67                         </para></listitem>
  68                 </varlistentry>
  69
  70                 <varlistentry>
  71                         <term>-s seed</term>
  72                         <listitem><para>
  73                                         Seed the random number generator with the specified value.
  74                         </para></listitem>
  75                 </varlistentry>
  76
  77                 <varlistentry>
  78                         <term>-o numops</term>
  79                         <listitem><para>Set the number of operations to perform.</para></listitem>
  80                 </varlistentry>
  81
  82                 <varlistentry>
  83                         <term>-a</term>
  84                         <listitem><para>Print the operations that are performed. </para></listitem>
  85                 </varlistentry>
  86
  87                 <varlistentry>
  88                         <term>-A</term>
  89                         <listitem><para>Backtrack to find minimal number of operations
  90                                         required to make the response to a certain call differ.
  91                         </para></listitem>
  92                 </varlistentry>
  93
  94                 <varlistentry>
  95                         <term>-O</term>
  96                         <listitem><para>Enable oplocks.</para></listitem>
  97                 </varlistentry>
  98
  99                 <varlistentry>
 100                         <term>-u</term>
 101                         <listitem><para>Hide unlock fails.</para></listitem>
 102                 </varlistentry>
 103
 104                 <varlistentry>
 105                         <term>-E</term>
 106                         <listitem><para>enable exact error code checking</para></listitem>
 107                 </varlistentry>
 108
 109                 <varlistentry>
 110                         <term>-Z</term>
 111                         <listitem><para>enable the zero/zero lock</para></listitem>
 112                 </varlistentry>
 113
 114                 <varlistentry>
 115                         <term>-R range</term>
 116                         <listitem><para>set lock range</para></listitem>
 117                 </varlistentry>
 118
 119                 <varlistentry>
 120                         <term>-B base</term>
 121                         <listitem><para>set lock base</para></listitem>
 122                 </varlistentry>
 123
 124                 <varlistentry>
 125                         <term>-M min</term>
 126                         <listitem><para>set min lock length</para></listitem>
 127                 </varlistentry>
 128
 129                 <varlistentry>
 130                         <term>-k</term>
 131                         <listitem><para>Use kerberos</para></listitem>
 132                 </varlistentry>
 133         </variablelist>
 134 </refsect1>
 135
 136 <refsect1>
 137         <title>VERSION</title>
 138
 139         <para>This man page is correct for version 4.0 of the Samba suite.</para>
 140 </refsect1>
 141
 142 <refsect1>
 143         <title>SEE ALSO</title>
 144
 145         <para>Samba</para>
 146
 147 </refsect1>
 148
 149 <refsect1>
 150         <title>AUTHOR</title>
 151
 152         <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>
 153
 154         <para>locktest was written by Andrew Tridgell.</para>
 155
 156         <para>This manpage was written by Jelmer Vernooij.</para>
 157
 158 </refsect1>
 159
 160 </refentry>