FreeBSD Manual Pages
VFS_CATIA(8) System Administration tools VFS_CATIA(8) 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 char- acter mapping so that these files can be shared with CIFS clients. This module is stackable. The parameter "catia:mappings" specifies the mapping on a per-character ba- sis, see below. OPTIONS catia:mappings = SERVER_HEX_CHAR:CLIENT_HEX_CHAR 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. The same mapping occurs in the opposite direction. Multiple character mappings are separated by a comma. EXAMPLES Map server-side quotation-marks (") to client-side diaeresis (") on file- names in the [CAD] share: [CAD] path = /data/cad vfs objects = catia catia:mappings = 0x22:0xa8 Perform comprehensive mapping of common Catia filename characters: [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 Server-side filename to be translated (Note that the path delimiter "/" is not used here): a\a:a*a?a"a<a>a|a Resulting filename, as seen by the client: aA?a/axa?a"a<<a>>a|a CAVEATS Character mapping must work in BOTH directions (server -> client and client -> server) 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 server-side filename "a:should_work", which is translated to "a_should_work" for the client. 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. VERSION This man page is part of Samba versions from 3.5.0 to 4.0.6. 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 Samba 4.23.8 08/01/2026 VFS_CATIA(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | CAVEATS | VERSION | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vfs_catia&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>