|Linux & Unix Commands - Search Man Pages
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 internationaliza-
tion 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 defi-
nition 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 codepages (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 informa-
tion, 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 (Traditional Chinese). Users are encouraged to write text codepage defi-
nition files for their own code pages and donate them to firstname.lastname@example.org. 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 source/codepages direc-
A text codepage definition file consists of multiple lines containing four fields. These
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
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 character 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 character to the given upper case character
when upper casing a filename.
codepage.<codepage> - These are the output (binary) codepage files produced and placed in
the Samba destination lib/codepage directory.
The location of the server and its support files is a matter for individual system admin-
istrators. 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, writeable 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 con-
verted 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
19 November 2002 MAKE_SMBCODEPAGE(1)
All times are GMT -4. The time now is 02:53 PM.