summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/locking/strictlocking.xml
blob: 89a1bf7eb3a72baff7d64eee7fd96a0f35b185b4 (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
<samba:parameter name="strict locking"
                 context="S"
                 type="enum"
                 enumlist="enum_bool_auto"
                 parm="1"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
	<para>
	This is an enumerated type that controls the handling of file locking in the server. When this is set to <constant>yes</constant>,
	the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on 
	some systems.
	</para>

	<para>
	When strict locking is set to Auto (the default), the server performs file lock checks only on non-oplocked files.
	As most Windows redirectors perform file locking checks locally on oplocked files this is a good trade off for
	improved performance.
	</para>

	<para>
	When strict locking is disabled, the server performs file lock checks only when the client explicitly asks for them.
	</para>

	<para>
	Well-behaved clients always ask for lock checks when it is important.  So in the vast majority of cases, 
	 <command moreinfo="none">strict locking = Auto</command> or
	 <command moreinfo="none">strict locking = no</command> is acceptable.
	</para>
</description>
<value type="default">Auto</value>
</samba:parameter>