Debian Codegraph @

source4/torture/man/locktest.1.xml

raw
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>