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       The parameter "catia:mappings" specifies the mapping on a per-character
22       basis, see below.
23

OPTIONS

25       catia:mappings = SERVER_HEX_CHAR:CLIENT_HEX_CHAR
26           SERVER_HEX_CHAR specifies a 0x prefixed hexedecimal character code
27           that, when included in a Samba server-side filename, will be mapped
28           to CLIENT_HEX_CHAR for the CIFS client.
29
30           The same mapping occurs in the opposite direction. Multiple
31           character mappings are separated by a comma.
32

EXAMPLES

34       Map server-side quotation-marks (") to client-side diaeresis (¨) on
35       filenames in the [CAD] share:
36
37                   [CAD]
38                path = /data/cad
39                vfs objects = catia
40                catia:mappings = 0x22:0xa8
41
42       Perform comprehensive mapping of common Catia filename characters:
43
44                   [CAD]
45                path = /data/cad
46                vfs objects = catia
47                catia:mappings = 0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6
48
49       Server-side filename to be translated (Note that the path delimiter "/"
50       is not used here):
51
52       a\a:a*a?a"a<a>a|a
53
54       Resulting filename, as seen by the client:
55
56       aÿa÷a¤a¿a¨a«a»a¦a
57

CAVEATS

59       Character mapping must work in BOTH directions (server -> client and
60       client -> server) to get unique and existing file names!
61
62       A NOT working example:
63
64                   [CAD]
65                path = /data/cad
66                vfs objects = catia
67                catia:mappings = 0x3a:0x5f
68
69       Here the colon ":" is mapped to the underscore "_".
70
71       Assuming a server-side filename "a:should_work", which is translated to
72       "a_should_work" for the client.
73
74       BUT the reverse mapping from client "a_should_work" to server will
75       result in "a:should:work" - something like "file not found" will be
76       returned.
77

VERSION

79       This man page is part of Samba versions from 3.5.0 to 4.0.6.
80

AUTHOR

82       The original Samba software and related utilities were created by
83       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
84       Source project similar to the way the Linux kernel is developed.
85
86       New version written by Guenter Kukkukk kukks@samba.org
87
88
89
90Samba 4.17.5                      01/26/2023                      VFS_CATIA(8)
Impressum