diff options
author | Guenter Kukkukk <kukks@samba.org> | 2013-03-09 04:45:15 +0100 |
---|---|---|
committer | Karolin Seeger <kseeger@samba.org> | 2013-03-11 09:20:04 +0100 |
commit | 17113c33a77a257560f33dbb35286ae20250a8f5 (patch) | |
tree | 75c61e902091ccb5e147c46e4b1a63e7319018f2 /docs-xml | |
parent | ddb98cae501020e2fc02523b4083d16dc44d8908 (diff) | |
download | samba-17113c33a77a257560f33dbb35286ae20250a8f5.tar.gz |
vfs_catia: new version of the manual page for samba-3.6.x
well, i was not aware of the change
./docs-xml/manpages-3/
./docs-xml/manpages/
in samba-4.0.x
Signed-off-by: Guenter Kukkukk <kukks@samba.org>
The last 4 patches address bug #9701 - vfs_catia is not working anymore (due to
a former regression).
Diffstat (limited to 'docs-xml')
-rw-r--r-- | docs-xml/manpages-3/vfs_catia.8.xml | 66 |
1 files changed, 64 insertions, 2 deletions
diff --git a/docs-xml/manpages-3/vfs_catia.8.xml b/docs-xml/manpages-3/vfs_catia.8.xml index f1368a02c62..a786ecd6eb9 100644 --- a/docs-xml/manpages-3/vfs_catia.8.xml +++ b/docs-xml/manpages-3/vfs_catia.8.xml @@ -31,18 +31,31 @@ <para>The Catia CAD package commonly creates filenames that use characters that are illegal in CIFS filenames. The - <command>vfs_catia</command> VFS module implements a fixed character + <command>vfs_catia</command> VFS module implements a character mapping so that these files can be shared with CIFS clients. </para> <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> + + <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> <refsect1> <title>EXAMPLES</title> + <para>Samba versions up to 3.4.x:</para> <para>Map Catia filenames on the [CAD] share:</para> <programlisting> @@ -51,12 +64,60 @@ <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> + +<programlisting> + <smbconfsection name="[CAD]"/> + <smbconfoption name="path">/data/cad</smbconfoption> + <smbconfoption name="vfs objects">catia</smbconfoption> + <smbconfoption name="catia:mappings">0x22:0xa8</smbconfoption> +</programlisting> + + <para>To get the full formerly fixed mappings:</para> +<programlisting> + <smbconfsection name="[CAD]"/> + <smbconfoption name="path">/data/cad</smbconfoption> + <smbconfoption name="vfs objects">catia</smbconfoption> + <smbconfoption name="catia:mappings">0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6,0x20:0xb1</smbconfoption> +</programlisting> + + <para>Unix filename to be translated (Note that the path delimiter "/" is not used here): + </para> + <para>a\a:a*a?a"a<a>a|a a</para> + + <para>Resulting windows filename:</para> + + <para>aÿa÷a¤a¿a¨a«a»a¦a±a + </para> + + <para>Note that the character mapping must work in BOTH directions + (unix -> windows and windows -> unix) to get unique and existing file names! + </para> + + <para>A NOT working example:</para> + +<programlisting> + <smbconfsection name="[CAD]"/> + <smbconfoption name="path">/data/cad</smbconfoption> + <smbconfoption name="vfs objects">catia</smbconfoption> + <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> + </refsect1> <refsect1> <title>VERSION</title> - <para>This man page is correct for version 3.0.25 of the Samba suite. + <para>This man page is correct for all versions up to 4.0.3 of the Samba suite. </para> </refsect1> @@ -67,6 +128,7 @@ were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.</para> + <para>New version written by Guenter Kukkukk kukks@samba.org</para> </refsect1> |