From ebdf147d4a84bb092e795cefac1a4e28393fd343 Mon Sep 17 00:00:00 2001
From: Michael Adam <obnox@samba.org>
Date: Mon, 10 Sep 2012 00:50:38 +0200
Subject: docs: describe the new parameter "durable handles" in the smb.conf
 manpage

---
 docs-xml/smbdotconf/protocol/durablehandles.xml | 27 +++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs-xml/smbdotconf/protocol/durablehandles.xml

(limited to 'docs-xml')

diff --git a/docs-xml/smbdotconf/protocol/durablehandles.xml b/docs-xml/smbdotconf/protocol/durablehandles.xml
new file mode 100644
index 0000000000..011fabd8ab
--- /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>
-- 
cgit