syncing tree with SAMBA_3_0
[Samba.git] / docs / docbook / smbdotconf / filename / mangledstack.xml
blob5f28e76dd91155b0297769bdcf73243a09f17acc
1 <samba:parameter name="mangled stack"
2                  context="G"
3                  advanced="1" developer="1"
4                  xmlns:samba="http://samba.org/common">
5 <listitem>
6         <para>This parameter controls the number of mangled names 
7         that should be cached in the Samba server <citerefentry><refentrytitle>smbd</refentrytitle>
8         <manvolnum>8</manvolnum></citerefentry>.</para>
10         <para>This stack is a list of recently mangled base names 
11         (extensions are only maintained if they are longer than 3 characters 
12         or contains upper case characters).</para>
14         <para>The larger this value, the more likely it is that mangled 
15         names can be successfully converted to correct long UNIX names. 
16         However, large stack sizes will slow most directory accesses. Smaller 
17         stacks save memory in the server (each stack element costs 256 bytes).
18         </para>
20         <para>It is not possible to absolutely guarantee correct long 
21         filenames, so be prepared for some surprises!</para>
23         <para>Default: <command moreinfo="none">mangled stack = 50</command></para>
25         <para>Example: <command moreinfo="none">mangled stack = 100</command></para>
26 </listitem>
27 </samba:parameter>