Adding upstream version 2:4.17.12+dfsg.upstream/2%4.17.12+dfsgupstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 28 insertions, 0 deletions

diff --git a/docs-xml/smbdotconf/misc/dmapisupport.xml b/docs-xml/smbdotconf/misc/dmapisupport.xml
new file mode 100644
index 0000000..de284ee
--- /dev/null
+++ b/docs-xml/smbdotconf/misc/dmapisupport.xml
@@ -0,0 +1,28 @@
+<samba:parameter name="dmapi support"
+                 context="S"
+                 type="boolean"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+	<para>This parameter specifies whether Samba should use DMAPI to
+	determine whether a file is offline or not. This would typically
+	be used in conjunction with a hierarchical storage system that
+	automatically migrates files to tape.
+	</para>
+
+	<para>Note that Samba infers the status of a file by examining the
+	events that a DMAPI application has registered interest in. This
+	heuristic is satisfactory for a number of hierarchical storage
+	systems, but there may be system for which it will fail. In this
+	case, Samba may erroneously report files to be offline.
+	</para>
+
+	<para>This parameter is only available if a supported DMAPI
+	implementation was found at compilation time. It will only be used
+	if DMAPI is found to enabled on the system at run time.
+	</para>
+
+	<para>
+	</para>
+</description>
+<value type="default">no</value>
+</samba:parameter>