summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/locking/oplockcontentionlimit.xml
blob: 1b24e5cdec6f9259c42add5d91b6a01a69e30924 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<samba:parameter name="oplock contention limit"
                 context="S"
                 xmlns:samba="http://samba.org/common">
<listitem>
	<para>This is a <emphasis>very</emphasis> advanced
	<citerefentry><refentrytitle>smbd</refentrytitle>
	<manvolnum>8</manvolnum></citerefentry> tuning option to 
	improve the efficiency of the granting of oplocks under multiple 
	client contention for the same file.</para>
		
	<para>In brief it specifies a number, which causes <citerefentry><refentrytitle>smbd</refentrytitle>
	<manvolnum>8</manvolnum></citerefentry>not to grant an oplock even when requested 
	if the approximate number of clients contending for an oplock on the same file goes over this 
	limit. This causes <command moreinfo="none">smbd</command> to behave in a similar 
	way to Windows NT.</para>

	<para><emphasis>DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ 
	AND UNDERSTOOD THE SAMBA OPLOCK CODE</emphasis>.</para>

	<para>Default: <command moreinfo="none">oplock contention limit = 2</command></para>
</listitem>
</samba:parameter>