mirror of
https://github.com/samba-team/samba.git
synced 2024-12-25 23:21:54 +03:00
de23fd66e4
These are not valid smbconfoptions, so we end up with dangling links. Signed-off-by: Joseph Sutton <josephsutton@catalyst.net.nz> Reviewed-by: Andrew Bartlett <abartlet@samba.org>
78 lines
3.0 KiB
XML
78 lines
3.0 KiB
XML
<samba:parameter name="mangled names"
|
|
type="enum"
|
|
enumlist="enum_mangled_names"
|
|
context="S"
|
|
parm="1"
|
|
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
|
|
<description>
|
|
<para>This controls whether non-DOS names under UNIX
|
|
should be mapped to DOS-compatible names ("mangled") and made visible,
|
|
or whether non-DOS names should simply be ignored.</para>
|
|
|
|
<para>See the section on <link linkend="NAMEMANGLINGSECT">name mangling</link> for
|
|
details on how to control the mangling process.</para>
|
|
|
|
<para>Possible option settings are</para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para><emphasis>yes</emphasis> -
|
|
enables name mangling for all not DOS 8.3 conforming
|
|
names.</para></listitem>
|
|
|
|
<listitem><para><emphasis>no</emphasis> - disables any
|
|
name mangling.</para></listitem>
|
|
|
|
<listitem><para><emphasis>illegal (default)</emphasis> - does
|
|
mangling for names with illegal NTFS characters. This
|
|
is the most sensible setting for modern clients that
|
|
don't use the shortname anymore.</para></listitem>
|
|
</itemizedlist>
|
|
|
|
<para>If mangling is used then the mangling method is as follows:</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>The first (up to) five alphanumeric characters
|
|
before the rightmost dot of the filename are preserved, forced
|
|
to upper case, and appear as the first (up to) five characters
|
|
of the mangled name.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>A tilde "~" is appended to the first part of the mangled
|
|
name, followed by a two-character unique sequence, based on the
|
|
original root name (i.e., the original filename minus its final
|
|
extension). The final extension is included in the hash calculation
|
|
only if it contains any upper case characters or is longer than three
|
|
characters.</para>
|
|
|
|
<para>Note that the character to use may be specified using
|
|
the <smbconfoption name="mangling char"/>
|
|
option, if you don't like '~'.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Files whose UNIX name begins with a dot will be
|
|
presented as DOS hidden files. The mangled name will be created as
|
|
for other filenames, but with the leading dot removed and "___" as
|
|
its extension regardless of actual original extension (that's three
|
|
underscores).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<para>The two-digit hash value consists of upper case alphanumeric characters.</para>
|
|
|
|
<para>This algorithm can cause name collisions only if files
|
|
in a directory share the same first five alphanumeric characters.
|
|
The probability of such a clash is 1/1300.</para>
|
|
|
|
<para>The name mangling (if enabled) allows a file to be
|
|
copied between UNIX directories from Windows/DOS while retaining
|
|
the long UNIX filename. UNIX files can be renamed to a new extension
|
|
from Windows/DOS and will retain the same basename. Mangled names
|
|
do not change between sessions.</para>
|
|
</description>
|
|
<value type="default">illegal</value>
|
|
<value type="example">no</value>
|
|
</samba:parameter>
|