This commit was manufactured by cvs2svn to create branch 'SAMBA_3_0'.(This used to be commit 381649916ecbaddefbb6ee0e6137b7cc73eb54b1)

1 files changed, 27 insertions, 0 deletions

diff --git a/docs/docbook/smbdotconf/filename/mangledstack.xml b/docs/docbook/smbdotconf/filename/mangledstack.xml
new file mode 100644
index 0000000000..42083d13a2
--- /dev/null
+++ b/docs/docbook/smbdotconf/filename/mangledstack.xml
@@ -0,0 +1,27 @@
+<samba:parameter name="mangling stack"
+                 context="G"
+                 advanced="1" developer="1"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This parameter controls the number of mangled names 
+	that should be cached in the Samba server <citerefentry><refentrytitle>smbd</refentrytitle>
+	<manvolnum>8</manvolnum></citerefentry>.</para>
+
+	<para>This stack is a list of recently mangled base names 
+	(extensions are only maintained if they are longer than 3 characters 
+	or contains upper case characters).</para>
+
+	<para>The larger this value, the more likely it is that mangled 
+	names can be successfully converted to correct long UNIX names. 
+	However, large stack sizes will slow most directory accesses. Smaller 
+	stacks save memory in the server (each stack element costs 256 bytes).
+	</para>
+
+	<para>It is not possible to absolutely guarantee correct long 
+	filenames, so be prepared for some surprises!</para>
+
+	<para>Default: <command moreinfo="none">mangled stack = 50</command></para>
+
+  	<para>Example: <command moreinfo="none">mangled stack = 100</command></para>
+</listitem>
+</samba:parameter>