563042abd8d74e6fee7e7c743b8abcdd77cefd0d
[sfrench/samba-autobuild/.git] / docs-xml / smbdotconf / locking / strictlocking.xml
1 <samba:parameter name="strict locking"
2                  context="S"
3                  type="enum"
4                  parm="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7         <para>
8         This is an enumerated type that controls the handling of file locking in the server. When this is set to <constant>yes</constant>,
9         the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on 
10         some systems.
11         </para>
12
13         <para>
14         When strict locking is set to Auto (the default), the server performs file lock checks only on non-oplocked files.
15         As most Windows redirectors perform file locking checks locally on oplocked files this is a good trade off for
16         improved performance.
17         </para>
18
19         <para>
20         When strict locking is disabled, the server performs file lock checks only when the client explicitly asks for them.
21         </para>
22
23         <para>
24         Well-behaved clients always ask for lock checks when it is important.  So in the vast majority of cases, 
25          <command moreinfo="none">strict locking = Auto</command> or
26          <command moreinfo="none">strict locking = no</command> is acceptable.
27         </para>
28 </description>
29 <value type="default">Auto</value>
30 </samba:parameter>