docs: add desciption of new parameter "kernel share modes" to the smb.conf manpage
[gd/samba-autobuild/.git] / docs-xml / smbdotconf / locking / kernelsharemodes.xml
1 <samba:parameter name="kernel share modes"
2                  type="boolean"
3                  context="S"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>
7         This parameter controls whether SMB share modes are
8         translated into UNIX flocks.
9         </para>
10
11         <para>
12         Kernel share modes provide a minimal level of interoperability
13         with local UNIX processes and NFS operations by preventing
14         access with flocks corresponding to the SMB share modes.
15         Generally, it is very desirable to leave this enabled.
16         </para>
17
18         <para>
19         Note that in order to use SMB2 durable file handles on a share,
20         you have to turn kernel share modes off.
21         </para>
22
23         <para>
24         This parameter defaults to <constant>yes</constant> and
25         is translated to a no-op on systems that do not have the
26          necessary kernel flock support.
27         </para>
28 </description>
29
30 <value type="default">yes</value>
31 </samba:parameter>