1VFS_CATIA(8)              System Administration tools             VFS_CATIA(8)
2
3
4

NAME

6       vfs_catia - translate illegal characters in Catia filenames
7

SYNOPSIS

9       vfs objects = catia
10

DESCRIPTION

12       This VFS module is part of the samba(7) suite.
13
14       The Catia CAD package commonly creates filenames that use characters
15       that are illegal in CIFS filenames. The vfs_catia VFS module implements
16       a character mapping so that these files can be shared with CIFS
17       clients.
18
19       This module is stackable.
20
21       Up to samba version 3.4.x a fixed character mapping was used. The
22       invalid windows characters \ / : * ? " < > | and the blank character
23       were mapped in a hardcoded way.
24
25       Starting with samba-3.5.0 a more flexible mapping was introduced. The
26       new parameter "catia:mappings" now specifies the mapping on a char by
27       char basis using the notation: unix hex char 0x.. : windows hex char
28       0x.. Multiple character mappings are separated by a comma.
29

EXAMPLES

31       Samba versions up to 3.4.x:
32
33       Map Catia filenames on the [CAD] share:
34
35                   [CAD]
36                path = /data/cad
37                vfs objects = catia
38
39       Samba versions 3.5.0 and later:
40
41       Map Catia filenames on the [CAD] share:
42
43                   [CAD]
44                path = /data/cad
45                vfs objects = catia
46                catia:mappings = 0x22:0xa8
47
48       To get the full formerly fixed mappings:
49
50                   [CAD]
51                path = /data/cad
52                vfs objects = catia
53                catia:mappings = 0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6,0x20:0xb1
54
55       Unix filename to be translated (Note that the path delimiter "/" is not
56       used here):
57
58       a\a:a*a?a"a<a>a|a a
59
60       Resulting windows filename:
61
62       aÿa÷a¤a¿a¨a«a»a¦a±a
63
64       Note that the character mapping must work in BOTH directions (unix ->
65       windows and windows -> unix) to get unique and existing file names!
66
67       A NOT working example:
68
69                   [CAD]
70                path = /data/cad
71                vfs objects = catia
72                catia:mappings = 0x3a:0x5f
73
74       Here the colon ":" is mapped to the underscore "_".
75
76       Assuming a unix filename "a:should_work", which is well translated to
77       windows as "a_should_work".
78
79       BUT the reverse mapping from windows "a_should_work" to unix will
80       result in "a:should:work" - something like "file not found" will be
81       returned.
82

VERSION

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

AUTHOR

88       The original Samba software and related utilities were created by
89       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
90       Source project similar to the way the Linux kernel is developed.
91
92       New version written by Guenter Kukkukk kukks@samba.org
93
94
95
96Samba 3.6                         04/11/2016                      VFS_CATIA(8)
Impressum