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/tuning/allocationroundupsize.xml b/docs-xml/smbdotconf/tuning/allocationroundupsize.xml
new file mode 100644
index 0000000..08aa621
--- /dev/null
+++ b/docs-xml/smbdotconf/tuning/allocationroundupsize.xml
@@ -0,0 +1,28 @@
+<samba:parameter name="allocation roundup size"
+                 context="S"
+                 type="bytes"
+                 deprecated="1"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+    <para>This parameter allows an administrator to tune the 
+    allocation size reported to Windows clients. This is only
+    useful for old SMB1 clients because modern SMB dialects
+    eliminated that bottleneck and have better performance by
+    default.  Using this parameter may cause
+    difficulties for some applications, e.g. MS Visual Studio.
+    If the MS Visual Studio compiler starts to crash with an
+    internal error, set this parameter to zero for this share.
+    Settings this parameter to a large value can also cause
+    small files to allocate more space on the disk than
+    needed.
+    </para>
+    <para>This parameter is deprecated and will be removed in
+    one of the next Samba releases.
+    </para>
+
+    <para>The integer parameter specifies the roundup size in bytes.</para>
+</description>
+
+<value type="default">0</value>
+<value type="example">1048576<comment>(to set it to the former default of 1 MiB)</comment></value>
+</samba:parameter>