NAME¶

vfs_catia - translate illegal characters in Catia filenames

SYNOPSIS¶

vfs objects = catia

DESCRIPTION¶

This VFS module is part of the samba(7) suite.

The Catia CAD package commonly creates filenames that use characters that are illegal in CIFS filenames. The vfs_catia VFS module implements a character mapping so that these files can be shared with CIFS clients.

This module is stackable.

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.

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.

EXAMPLES¶

Samba versions up to 3.4.x:

Map Catia filenames on the [CAD] share:

        [CAD]
	path = /data/cad
	vfs objects = catia

Samba versions 3.5.0 and later:

Map Catia filenames on the [CAD] share:

        [CAD]
	path = /data/cad
	vfs objects = catia
	catia:mappings = 0x22:0xa8

To get the full formerly fixed mappings:

        [CAD]
	path = /data/cad
	vfs objects = catia
	catia:mappings = 0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6,0x20:0xb1

Unix filename to be translated (Note that the path delimiter "/" is not used here):

a\a:a*a?a"a<a>a|a a

Resulting windows filename:

aÿa÷a¤a¿a¨a«a»a¦a±a

Note that the character mapping must work in BOTH directions (unix -> windows and windows -> unix) to get unique and existing file names!

A NOT working example:

        [CAD]
	path = /data/cad
	vfs objects = catia
	catia:mappings = 0x3a:0x5f

Here the colon ":" is mapped to the underscore "_".

Assuming a unix filename "a:should_work", which is well translated to windows as "a_should_work".

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.

VERSION¶

This man page is correct for all versions up to 4.0.3 of the Samba suite.

AUTHOR¶

The original Samba software and related utilities 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.

New version written by Guenter Kukkukk kukks@samba.org