make_smbcodepage - construct a codepage file for Samba
make_smbcodepage c|d codepage inputfile outputfile
This tool is part of the Samba suite.
make_smbcodepage compiles or de-compiles codepage files for use with
the internationalization features of Samba 2.2
c|d This tells make_smbcodepage if it is compiling (c) a text format
code page file to binary, or (d) de-compiling a binary codepage
file to text.
This is the codepage we are processing (a number, e.g. 850).
This is the input file to process. In the c case this will be a
text codepage definition file such as the ones found in the
Samba source/codepages directory. In the d case this will be the
binary format codepage definition file normally found in the
lib/codepages directory in the Samba install directory path.
This is the output file to produce.
SAMBA CODEPAGE FILES
A text Samba codepage definition file is a description that tells Samba
how to map from upper to lower case for characters greater than ascii
127 in the specified DOS code page. Note that for certain DOS code-
pages (437 for example) mapping from lower to upper case may be non-
symmetrical. For example, in code page 437 lower case a acute maps to a
plain upper case A when going from lower to upper case, but plain upper
case A maps to plain lower case a when lower casing a character.
A binary Samba codepage definition file is a binary representation of
the same information, including a value that specifies what codepage
this file is describing.
As Samba does not yet use UNICODE (current for Samba version 2.2) you
must specify the client code page that your DOS and Windows clients are
using if you wish to have case insensitivity done correctly for your
particular language. The default codepage Samba uses is 850 (Western
European). Text codepage definition sample files are provided in the
Samba distribution for codepages 437 (USA), 737 (Greek), 850 (Western
European) 852 (MS-DOS Latin 2), 861 (Icelandic), 866 (Cyrillic), 932
(Kanji SJIS), 936 (Simplified Chinese), 949 (Hangul) and 950 (Tradi-
tional Chinese). Users are encouraged to write text codepage definition
files for their own code pages and donate them to email@example.com. All
codepage files in the Samba source/codepages directory are compiled and
installed when a 'make install' command is issued there.
The client codepage used by the smbd server is configured using the
client code page parameter in the smb.conf file.
These are the input (text) codepage files provided in the Samba
A text codepage definition file consists of multiple lines containing
four fields. These fields are:
o lower: which is the (hex) lower case character mapped on this line.
o upper: which is the (hex) upper case character that the lower case
character will map to.
o map upper to lower which is a boolean value (put either True or False
here) which tells Samba if it is to map the given upper case charac-
ter to the given lower case character when lower casing a filename.
o map lower to upper which is a boolean value (put either True or False
here) which tells Samba if it is to map the given lower case charac-
ter to the given upper case character when upper casing a filename.
codepage.<codepage> - These are the output (binary) codepage files pro-
duced and placed in the Samba destination lib/codepage directory.
The location of the server and its support files is a matter for indi-
vidual system administrators. The following are thus suggestions only.
It is recommended that the make_smbcodepage program be installed under
the /usr/local/samba hierarchy, in a directory readable by all, write-
able only by root. The program itself should be executable by all. The
program should NOT be setuid or setgid!
This man page is correct for version 2.2 of the Samba suite.
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.
The original Samba man pages were written by Karl Auer. The man page
sources were converted to YODL format (another excellent piece of Open
Source software, available at ftp://ftp.icce.rug.nl/pub/unix/
<URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
release by Jeremy Allison. The conversion to DocBook for Samba 2.2 was
done by Gerald Carter
19 November 2002 MAKE_SMBCODEPAGE(1)