docs: describe the new parameter "durable handles" in the smb.conf manpage
[Samba/gebeck_regimport.git] / docs-xml / smbdotconf / protocol / durablehandles.xml
blob011fabd8ab993dc04bbc5d00bf5a0b608a9a200b
1 <samba:parameter name="durable handles"
2                  context="S"
3                  advanced="1"
4                  type="boolean"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>
8     This boolean parameter controls
9     whether Samba can grant SMB2 durable file handles on a share.
10     </para>
11     <para>
12     Note that durable handles are only enabled if
13     <smbconfoption name="kernel oplocks">no</smbconfoption>,
14     <smbconfoption name="kernel share modes">no</smbconfoption>, and
15     <smbconfoption name="posix locking">no</smbconfoption>,
16     i.e. if the share is configured for CIFS/SMB2 only access,
17     not supporting interoperability features with local UNIX processes
18     or NFS operations.
19     </para>
20     <para>
21     Also note that, for the time being, durability is not granted
22     for a handle that has the delete on close flag set.
23     </para>
24 </description>
26 <value type="default">yes</value>
27 </samba:parameter>