summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/filename/manglednames.xml
diff options
context:
space:
mode:
authorAlexander Bokovoy <ab@samba.org>2003-04-09 15:53:41 +0000
committerAlexander Bokovoy <ab@samba.org>2003-04-09 15:53:41 +0000
commit42233f5c5876c1fde9ada8aaac0f1f568aacc4df (patch)
treea9eb8a72e941b33fac8ca1c72726237c2f8639fc /docs/docbook/smbdotconf/filename/manglednames.xml
parent803e23f403bdb38d2523d73fd12083da486bca2f (diff)
downloadsamba-42233f5c5876c1fde9ada8aaac0f1f568aacc4df.tar.gz
samba-42233f5c5876c1fde9ada8aaac0f1f568aacc4df.tar.bz2
samba-42233f5c5876c1fde9ada8aaac0f1f568aacc4df.zip
Finish conversion of Filenames
(This used to be commit 8e0f0dbbbcb3179f1a868c72720e4eaf530e0a79)
Diffstat (limited to 'docs/docbook/smbdotconf/filename/manglednames.xml')
-rw-r--r--docs/docbook/smbdotconf/filename/manglednames.xml71
1 files changed, 40 insertions, 31 deletions
diff --git a/docs/docbook/smbdotconf/filename/manglednames.xml b/docs/docbook/smbdotconf/filename/manglednames.xml
index 41592b3159..4ec088d16f 100644
--- a/docs/docbook/smbdotconf/filename/manglednames.xml
+++ b/docs/docbook/smbdotconf/filename/manglednames.xml
@@ -1,21 +1,26 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="MANGLEDNAMES"/>mangled names (S)</term>
- <listitem><para>This controls whether non-DOS names under UNIX
- should be mapped to DOS-compatible names (&quot;mangled&quot;) and made visible,
- or whether non-DOS names should simply be ignored.</para>
+<samba:parameter name="mangled names"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This controls whether non-DOS names under UNIX
+ should be mapped to DOS-compatible names (&quot;mangled&quot;) 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>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link> for
+ details on how to control the mangling process.</para>
- <para>If mangling is used then the mangling algorithm is as follows:</para>
+ <para>If mangling is used then the mangling algorithm is as follows:</para>
- <itemizedlist>
- <listitem><para>The first (up to) five alphanumeric characters
+ <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>
+ of the mangled name.</para>
+ </listitem>
- <listitem><para>A tilde &quot;~&quot; is appended to the first part of the mangled
+ <listitem>
+ <para>A tilde &quot;~&quot; 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
@@ -24,35 +29,39 @@
<para>Note that the character to use may be specified using
the <link linkend="MANGLINGCHAR"><parameter moreinfo="none">mangling char</parameter>
- </link> option, if you don't like '~'.</para></listitem>
+ </link> option, if you don't like '~'.</para>
+ </listitem>
- <listitem><para>The first three alphanumeric characters of the final
+ <listitem>
+ <para>The first three alphanumeric characters of the final
extension are preserved, forced to upper case and appear as the
extension of the mangled name. The final extension is defined as that
part of the original filename after the rightmost dot. If there are no
dots in the filename, the mangled name will have no extension (except
- in the case of &quot;hidden files&quot; - see below).</para></listitem>
+ in the case of &quot;hidden files&quot; - see below).</para>
+ </listitem>
- <listitem><para>Files whose UNIX name begins with a dot will be
+ <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 &quot;___&quot; as
its extension regardless of actual original extension (that's three
- underscores).</para></listitem>
- </itemizedlist>
+ underscores).</para>
+ </listitem>
+ </itemizedlist>
- <para>The two-digit hash value consists of upper case
- alphanumeric characters.</para>
+ <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>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>
+ <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>
- <para>Default: <command moreinfo="none">mangled names = yes</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">mangled names = yes</command></para>
+</listitem>
+</samba:parameter>