From: Michael Adam <obnox@samba.org>
Date: Sun, 9 Sep 2012 22:50:38 +0000 (+0200)
Subject: docs: describe the new parameter "durable handles" in the smb.conf manpage
X-Git-Tag: samba-4.0.0rc1~106
X-Git-Url: http://git.samba.org/samba.git/?p=gd%2Fsamba-autobuild%2F.git;a=commitdiff_plain;h=ebdf147d4a84bb092e795cefac1a4e28393fd343

docs: describe the new parameter "durable handles" in the smb.conf manpage
---

diff --git a/docs-xml/smbdotconf/protocol/durablehandles.xml b/docs-xml/smbdotconf/protocol/durablehandles.xml
new file mode 100644
index 00000000000..011fabd8ab9
--- /dev/null
+++ b/docs-xml/smbdotconf/protocol/durablehandles.xml
@@ -0,0 +1,27 @@
+<samba:parameter name="durable handles"
+                 context="S"
+                 advanced="1"
+                 type="boolean"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+    <para>
+    This boolean parameter controls
+    whether Samba can grant SMB2 durable file handles on a share.
+    </para>
+    <para>
+    Note that durable handles are only enabled if
+    <smbconfoption name="kernel oplocks">no</smbconfoption>,
+    <smbconfoption name="kernel share modes">no</smbconfoption>, and
+    <smbconfoption name="posix locking">no</smbconfoption>,
+    i.e. if the share is configured for CIFS/SMB2 only access,
+    not supporting interoperability features with local UNIX processes
+    or NFS operations.
+    </para>
+    <para>
+    Also note that, for the time being, durability is not granted
+    for a handle that has the delete on close flag set.
+    </para>
+</description>
+
+<value type="default">yes</value>
+</samba:parameter>