1mailto(samba@samba.org) 
2
3manpage(make_smbcodepage htmlcommand((1)))(1)(23 Oct 1998)(Samba)(SAMBA)
4
5label(NAME)
6manpagename(make_smbcodepage)(Construct a codepage file for Samba)
7
8label(SYNOPSIS)
9manpagesynopsis() 
10
11bf(make_smbcodepage) [link(c|d)(cord)] link(codepage)(codepage) link(inputfile)(inputfile) link(outputfile)(outputfile)
12
13label(DESCRIPTION)
14manpagedescription()
15
16This program is part of the bf(Samba) suite.
17
18bf(make_smbcodepage) compiles or de-compiles codepage files for use
19with the internationalization features of Samba 2.0
20
21label(OPTIONS)
22manpageoptions()
23
24startdit()
25
26label(cord)
27dit(c|d) This tells bf(make_smbcodepage) if it is compiling (bf(c)) a text
28format code page file to binary, or (bf(d)) de-compiling a binary codepage
29file to text.
30
31label(codepage)
32dit(codepage) This is the codepage we are processing (a number, e.g. 850).
33
34label(inputfile)
35dit(inputfile) This is the input file to process. In the 'bf(c)' case this
36will be a text codepage definition file such as the ones found in the
37Samba em(source/codepages) directory. In the 'bf(d)' case this will be the
38binary format codepage definition file normally found in the
39em(lib/codepages) directory in the Samba install directory path.
40
41label(outputfile)
42dit(outputfile) This is the output file to produce.
43
44endit()
45
46label(SambaCodepageFiles)
47manpagesection(Samba Codepage Files)
48
49A text Samba codepage definition file is a description that tells
50Samba how to map from upper to lower case for characters greater than
51ascii 127 in the specified DOS code page.  Note that for certain DOS
52codepages (437 for example) mapping from lower to upper case may be
53non-symmetrical. For example, in code page 437 lower case a acute maps to
54a plain upper case A when going from lower to upper case, but
55plain upper case A maps to plain lower case a when lower casing a
56character.
57
58A binary Samba codepage definition file is a binary representation of
59the same information, including a value that specifies what codepage
60this file is describing.
61
62As Samba does not yet use UNICODE (current for Samba version 2.0) you
63must specify the client code page that your DOS and Windows clients
64are using if you wish to have case insensitivity done correctly for
65your particular language. The default codepage Samba uses is 850
66(Western European). Text codepage definition sample files are
67provided in the Samba distribution for codepages 437 (USA), 737
68(Greek), 850 (Western European) 852 (MS-DOS Latin 2), 861 (Icelandic),
69866 (Cyrillic), 932 (Kanji SJIS), 936 (Simplified Chinese), 949
70(Hangul) and 950 (Traditional Chinese). Users are encouraged to write
71text codepage definition files for their own code pages and donate
72them to email(samba@samba.org). All codepage files in the
73Samba em(source/codepages) directory are compiled and installed when a
74em('make install') command is issued there.
75
76The client codepage used by the url(bf(smbd))(smbd.8.html) server is
77configured using the url(bf(client code
78page))(smb.conf.5.html#clientcodepage) parameter in the
79url(bf(smb.conf))(smb.conf.5.html) file.
80
81label(FILES)
82manpagefiles()
83
84bf(codepage_def.<codepage>)
85
86These are the input (text) codepage files provided in the Samba
87em(source/codepages) directory.
88
89A text codepage definition file consists of multiple lines
90containing four fields. These fields are : 
91
92startit()
93
94it() bf(lower): which is the (hex) lower case character mapped on this
95line.
96
97it() bf(upper): which is the (hex) upper case character that the lower
98case character will map to.
99
100it() bf(map upper to lower) which is a boolean value (put either True
101or False here) which tells Samba if it is to map the given upper case
102character to the given lower case character when lower casing a
103filename.
104
105it() bf(map lower to upper) which is a boolean value (put either True
106or False here) which tells Samba if it is to map the given lower case
107character to the given upper case character when upper casing a
108filename.
109
110endit()
111
112bf(codepage.<codepage>) These are the output (binary) codepage files
113produced and placed in the Samba destination em(lib/codepage)
114directory.
115
116label(INSTALLATION)
117manpagesection(INSTALLATION)
118
119The location of the server and its support files is a matter for
120individual system administrators. The following are thus suggestions
121only.
122
123It is recommended that the bf(make_smbcodepage) program be installed
124under the em(/usr/local/samba) hierarchy, in a directory readable by
125all, writeable only by root. The program itself should be executable
126by all.  The program should NOT be setuid or setgid!
127
128label(VERSION)
129manpagesection(VERSION)
130
131This man page is correct for version 2.0 of the Samba suite.
132
133label(SEEALSO)
134manpageseealso()
135
136url(bf(smb.conf(5)))(smb.conf.5.html), url(bf(smbd (8)))(smbd.8.html)
137
138label(AUTHOR)
139manpageauthor()
140
141The original Samba software and related utilities were created by
142Andrew Tridgell email(samba@samba.org). Samba is now developed
143by the Samba Team as an Open Source project similar to the way the
144Linux kernel is developed.
145
146The original Samba man pages were written by Karl Auer. The man page
147sources were converted to YODL format (another excellent piece of Open
148Source software, available at
149url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/))
150and updated for the Samba2.0 release by Jeremy Allison.
151email(samba@samba.org).
152
153See url(bf(samba (7)))(samba.7.html) to find out how to get a full
154list of contributors and details on how to submit bug reports,
155comments etc.
156