make_smbcodepage - construct a codepage file for Samba
SYNOPSIS
make_smbcodepage c|d codepage inputfile outputfile
DESCRIPTION
This tool is part of the Sambasuite.
make_smbcodepage compiles or de-compiles codepage files
for use with the internationalization features of Samba
2.2
OPTIONS
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.
codepage
This is the codepage we are processing (a number,
e.g. 850).
inputfile
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.
outputfile
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-sym
metrical. 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 repre
sentation 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 ver
sion 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).
Samba distribution for codepages 437 (USA), 737 (Greek),
850 (Western European) 852 (MS-DOS Latin 2), 861 (Ice
landic), 866 (Cyrillic), 932 (Kanji SJIS), 936 (Simplified
Chinese), 949 (Hangul) and 950 (Traditional Chinese).
Users are encouraged to write text codepage definition
files for their own code pages and donate them to
samba@samba.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.
FILES
codepage_def.<codepage>
These are the input (text) codepage files provided in the
Samba source/codepages directory.
A text codepage definition file consists of multiple lines
containing four fields. These fields are:
· lower: which is the (hex) lower case character mapped on
this line.
· upper: which is the (hex) upper case character that the
lower case character will map to.
· 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.
· 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) code
page files produced and placed in the Samba destination
lib/codepage directory.
INSTALLATION
The location of the server and its support files is a mat
ter for individual 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, 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.
SEE ALSO
smbd(8), smb.conf(5)
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.
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, avail
able 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
Man(1) output converted with
man2html