summaryrefslogtreecommitdiff
path: root/docs/manpages-4/locktest.1.xml
blob: 5b386fdeb24fd5ebd1e43763c70d0654da37cc98 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<refentry id="locktest.1">

<refmeta>
	<refentrytitle>locktest</refentrytitle>
	<manvolnum>1</manvolnum>
</refmeta>


<refnamediv>
	<refname>locktest</refname>
	<refpurpose>Find differences in locking between two SMB servers</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
		<command>locktest</command>
		<arg choice="req">//server1/share1</arg>
		<arg choice="req">//server2/share2</arg>
		<arg choice="opt">-U user%pass</arg>
		<arg choice="opt">-U user%pass</arg>
		<arg choice="opt">-s seed</arg>
		<arg choice="opt">-o numops</arg>
		<arg choice="opt">-a</arg>
		<arg choice="opt">-O</arg>
		<arg choice="opt">-E</arg>
		<arg choice="opt">-Z</arg>
		<arg choice="opt">-R range</arg>
		<arg choice="opt">-B base</arg>
		<arg choice="opt">-M min</arg>
	</cmdsynopsis>
	
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>

	<para><application>locktest</application> is a utility for 
		detecting differences in behaviour in locking between SMB servers. 
		It will run a random set of locking operations against 
		<parameter>//server1/share1</parameter> and then the same 
		random set against <parameter>//server2/share2</parameter>
		and display the differences in the responses it gets.
	</para>

	<para>
		This utility is used by the Samba team to find differences in 
		behaviour between Samba and Windows servers. 
	</para>
</refsect1>


<refsect1>
	<title>OPTIONS</title>

	<variablelist>
		<varlistentry>
			<term>-U user%pass</term>
			<listitem><para>
					Specify the user and password to use when logging on 
					on the shares. This parameter can be specified twice 
					(once for the first server, once for the second).
			</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-s seed</term>
			<listitem><para>
					Seed the random number generator with the specified value.
			</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-o numops</term>
			<listitem><para>Set the number of operations to perform.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-a</term>
			<listitem><para>Print the operations that are performed. </para></listitem>
		</varlistentry>
		
		<varlistentry>
			<term>-A</term>
			<listitem><para>Backtrack to find minimal number of operations 
					required to make the response to a certain call differ.
			</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-O</term>
			<listitem><para>Enable oplocks.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-u</term>
			<listitem><para>Hide unlock fails.</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-E</term>
			<listitem><para>enable exact error code checking</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-Z</term>
			<listitem><para>enable the zero/zero lock</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-R range</term>
			<listitem><para>set lock range</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-B base</term>
			<listitem><para>set lock base</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-M min</term>
			<listitem><para>set min lock length</para></listitem>
		</varlistentry>

		<varlistentry>
			<term>-k</term>
			<listitem><para>Use kerberos</para></listitem>
		</varlistentry>
	</variablelist>
</refsect1>

<refsect1>
	<title>VERSION</title>

	<para>This man page is correct for version 4.0 of the Samba suite.</para>
</refsect1>

<refsect1>
	<title>SEE ALSO</title>

	<para>Samba</para>

</refsect1>

<refsect1>
	<title>AUTHOR</title>

	&man.credits.samba;

	<para>locktest was written by Andrew Tridgell.</para>

	<para>This manpage was written by Jelmer Vernooij.</para>
	
</refsect1>

</refentry>