diff options
author | David Disseldorp <ddiss@samba.org> | 2013-06-17 19:43:34 +0200 |
---|---|---|
committer | Jeremy Allison <jra@samba.org> | 2013-06-17 23:23:57 +0200 |
commit | d924da9bc82bbb9f088eb15ac58377e2a1ae3a58 (patch) | |
tree | 49b87f63e6c89f57708a7fc367445d9a42f12a0c | |
parent | 8ac17fff8008eaed82ea788c7aaae4c4b5b604eb (diff) | |
download | samba-d924da9bc82bbb9f088eb15ac58377e2a1ae3a58.tar.gz samba-d924da9bc82bbb9f088eb15ac58377e2a1ae3a58.tar.bz2 samba-d924da9bc82bbb9f088eb15ac58377e2a1ae3a58.zip |
docs/vfs_catia: rework man page
The vfs_catia man page refers to two configuration variants, one
applying to Samba <= 3.4.x and one referring to Samba >= 3.5.x.
This change removes all information specific to Samba <= 3.4.x, as such
versions have been discontinued.
This change also improves formatting and nomenclature: configuration
parameters, examples and caveats are split into separate sections, and
server-side/client-side terms replace the ambiguous use of Unix and
Windows.
Signed-off-by: David Disseldorp <ddiss@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
Autobuild-User(master): Jeremy Allison <jra@samba.org>
Autobuild-Date(master): Mon Jun 17 23:23:57 CEST 2013 on sn-devel-104
-rw-r--r-- | docs-xml/manpages/vfs_catia.8.xml | 71 |
1 files changed, 39 insertions, 32 deletions
diff --git a/docs-xml/manpages/vfs_catia.8.xml b/docs-xml/manpages/vfs_catia.8.xml index 42920d2922..02a9473632 100644 --- a/docs-xml/manpages/vfs_catia.8.xml +++ b/docs-xml/manpages/vfs_catia.8.xml @@ -37,35 +37,38 @@ <para>This module is stackable.</para> - <para>Up to samba version 3.4.x a fixed character mapping was used. - The invalid windows characters \ / : * ? " < > | and the blank - character were mapped in a hardcoded way. + <para>The parameter "catia:mappings" specifies the mapping on a + per-character basis, see below. </para> +</refsect1> - <para>Starting with samba-3.5.0 a more flexible mapping was introduced. - The new parameter "catia:mappings" now specifies the mapping on a char by char - basis using the notation: unix hex char 0x.. : windows hex char 0x.. - Multiple character mappings are separated by a comma. - </para> +<refsect1> + <title>OPTIONS</title> + <variablelist> + <varlistentry> + <term>catia:mappings = SERVER_HEX_CHAR:CLIENT_HEX_CHAR + </term> + <listitem> + <para>SERVER_HEX_CHAR specifies a 0x prefixed hexedecimal + character code that, when included in a Samba server-side + filename, will be mapped to CLIENT_HEX_CHAR for the CIFS + client.</para> + <para>The same mapping occurs in the opposite direction. + Multiple character mappings are separated by a comma.</para> + </listitem> + </varlistentry> + </variablelist> </refsect1> + <refsect1> <title>EXAMPLES</title> - <para>Samba versions up to 3.4.x:</para> - <para>Map Catia filenames on the [CAD] share:</para> - -<programlisting> - <smbconfsection name="[CAD]"/> - <smbconfoption name="path">/data/cad</smbconfoption> - <smbconfoption name="vfs objects">catia</smbconfoption> -</programlisting> - - <para>Samba versions 3.5.0 and later:</para> - <para>Map Catia filenames on the [CAD] share:</para> + <para>Map server-side quotation-marks (") to client-side diaeresis + (¨) on filenames in the [CAD] share:</para> <programlisting> <smbconfsection name="[CAD]"/> @@ -74,7 +77,7 @@ <smbconfoption name="catia:mappings">0x22:0xa8</smbconfoption> </programlisting> - <para>To get the full formerly fixed mappings:</para> + <para>Perform comprehensive mapping of common Catia filename characters:</para> <programlisting> <smbconfsection name="[CAD]"/> <smbconfoption name="path">/data/cad</smbconfoption> @@ -82,17 +85,21 @@ <smbconfoption name="catia:mappings">0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6</smbconfoption> </programlisting> - <para>Unix filename to be translated (Note that the path delimiter "/" is not used here): + <para>Server-side filename to be translated (Note that the path delimiter "/" is not used here): </para> <para>a\a:a*a?a"a<a>a|a</para> - <para>Resulting windows filename:</para> + <para>Resulting filename, as seen by the client:</para> <para>aÿa÷a¤a¿a¨a«a»a¦a </para> +</refsect1> - <para>Note that the character mapping must work in BOTH directions - (unix -> windows and windows -> unix) to get unique and existing file names! +<refsect1> + <title>CAVEATS</title> + + <para>Character mapping must work in BOTH directions (server -> + client and client -> server) to get unique and existing file names! </para> <para>A NOT working example:</para> @@ -104,20 +111,20 @@ <smbconfoption name="catia:mappings">0x3a:0x5f</smbconfoption> </programlisting> - <para>Here the colon ":" is mapped to the underscore "_".</para> - <para>Assuming a unix filename "a:should_work", which is well translated - to windows as "a_should_work".</para> - <para>BUT the reverse mapping from windows "a_should_work" to unix - will result in "a:should:work" - something like "file not found" - will be returned. - </para> + <para>Here the colon ":" is mapped to the underscore "_".</para> + <para>Assuming a server-side filename "a:should_work", which is + translated to "a_should_work" for the client.</para> + <para>BUT the reverse mapping from client "a_should_work" to server + will result in "a:should:work" - something like "file not found" + will be returned. + </para> </refsect1> <refsect1> <title>VERSION</title> - <para>This man page is correct for all versions up to 4.0.3 of the Samba suite. + <para>This man page is correct for Samba versions from 3.5.0 to 4.0.6. </para> </refsect1> |