summaryrefslogtreecommitdiff
path: root/docs/htmldocs/make_smbcodepage.1.html
blob: 4c2ad993ae821d281fbe5f67adc0909b99afe6fd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>make_smbcodepage</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><H1
><A
NAME="MAKE-SMBCODEPAGE"
></A
>make_smbcodepage</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN5"
></A
><H2
>Name</H2
>make_smbcodepage&nbsp;--&nbsp;construct a codepage file for Samba</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN8"
></A
><H2
>Synopsis</H2
><P
><B
CLASS="COMMAND"
>make_smbcodepage</B
>  {c|d} {codepage} {inputfile} {outputfile}</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15"
></A
><H2
>DESCRIPTION</H2
><P
>This tool is part of the <A
HREF="samba.7.html"
TARGET="_top"
>	Samba</A
> suite.</P
><P
><B
CLASS="COMMAND"
>make_smbcodepage</B
> compiles or de-compiles 
	codepage files for use with the internationalization features 
	of Samba 2.2</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21"
></A
><H2
>OPTIONS</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>c|d</DT
><DD
><P
>This tells <B
CLASS="COMMAND"
>make_smbcodepage</B
> 
		if it is compiling (<TT
CLASS="PARAMETER"
><I
>c</I
></TT
>) a text format code 
		page file to binary, or (<TT
CLASS="PARAMETER"
><I
>d</I
></TT
>) de-compiling 
		a binary codepage file to text. </P
></DD
><DT
>codepage</DT
><DD
><P
>This is the codepage we are processing (a 
		number, e.g. 850). </P
></DD
><DT
>inputfile</DT
><DD
><P
>This is the input file to process. In 
		the <TT
CLASS="PARAMETER"
><I
>c</I
></TT
> case, this will be a text 
		codepage definition file such as the ones found in the Samba 	
		<TT
CLASS="FILENAME"
>source/codepages</TT
> directory. In
		the <TT
CLASS="PARAMETER"
><I
>d</I
></TT
> case, this will be the 
		binary format codepage definition file normally found in 
		the <TT
CLASS="FILENAME"
>lib/codepages</TT
> directory in the 
		Samba install directory path.</P
></DD
><DT
>outputfile</DT
><DD
><P
>This is the output file to produce.</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN47"
></A
><H2
>Samba Codepage Files</H2
><P
>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. </P
><P
>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. </P
><P
>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 definition files for
	their own code pages and donate them to samba@samba.org. All codepage files
	in the Samba <TT
CLASS="FILENAME"
>source/codepages</TT
> directory are 
 	compiled and installed when a <B
CLASS="COMMAND"
>'make install'</B
> 
	command is issued there. </P
><P
>The client codepage used by the <B
CLASS="COMMAND"
>smbd</B
> server 
	is configured using the <B
CLASS="COMMAND"
>client code page</B
> parameter 
	in the <B
CLASS="COMMAND"
>smb.conf</B
> file. </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN58"
></A
><H2
>Files</H2
><P
><B
CLASS="COMMAND"
>codepage_def.&lt;codepage&gt;</B
></P
><P
>These are the input (text) codepage files provided in the 
	Samba <TT
CLASS="FILENAME"
>source/codepages</TT
> directory.</P
><P
>A text codepage definition file consists of multiple lines 
	containing four fields. These fields are:</P
><P
></P
><UL
><LI
><P
><B
CLASS="COMMAND"
>lower</B
>: which is the 
		(hex) lower case character mapped on this line.</P
></LI
><LI
><P
><B
CLASS="COMMAND"
>upper</B
>: which is the (hex) 
		upper case character that the lower case character will map to.
		</P
></LI
><LI
><P
><B
CLASS="COMMAND"
>map upper to lower</B
> 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.
		</P
></LI
><LI
><P
><B
CLASS="COMMAND"
>map lower to upper</B
> 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.
		</P
></LI
></UL
><P
><B
CLASS="COMMAND"
>codepage.&lt;codepage&gt;</B
> - These are the 
	output (binary) codepage files produced  and placed in the Samba 
	destination <TT
CLASS="FILENAME"
>lib/codepage</TT
> directory. </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN81"
></A
><H2
>Installation</H2
><P
>The location of the server and its support files is a 
	matter for individual system administrators. The following are 
	thus suggestions only. </P
><P
>It is recommended that the <B
CLASS="COMMAND"
>make_smbcodepage
	</B
> program be installed under the <TT
CLASS="FILENAME"
>/usr/local/samba
	</TT
> 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! </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN87"
></A
><H2
>VERSION</H2
><P
>This man page is correct for version 2.2 of 
	the Samba suite.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN90"
></A
><H2
>SEE ALSO</H2
><P
><A
HREF="smbd.8.html"
TARGET="_top"
><B
CLASS="COMMAND"
>smbd(8)</B
></A
>, 
	<A
HREF="smb.conf.5.html"
TARGET="_top"
>smb.conf(5)</A
>
	</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN96"
></A
><H2
>AUTHOR</H2
><P
>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.</P
><P
>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
	<A
HREF="ftp://ftp.icce.rug.nl/pub/unix/"
TARGET="_top"
>	ftp://ftp.icce.rug.nl/pub/unix/</A
>) and updated for the Samba 2.0 
	release by Jeremy Allison.  The conversion to DocBook for 
	Samba 2.2 was done by Gerald Carter</P
></DIV
></BODY
></HTML
>