Penguin
Recent Changes
Blame: make_smbcodepage(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of make_smbcodepage(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 MAKE_SMBCODEPAGE
2 !!!MAKE_SMBCODEPAGE
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SAMBA CODEPAGE FILES
8 FILES
9 INSTALLATION
10 VERSION
11 SEE ALSO
12 AUTHOR
13 ----
14 !!NAME
15
16
17 make_smbcodepage - construct a codepage file for Samba
18 !!SYNOPSIS
19
20
21 __make_smbcodepage c|d codepage inputfile
22 outputfile__
23 !!DESCRIPTION
24
25
26 This tool is part of the Sambasuite.
27
28
29 __make_smbcodepage__ compiles or de-compiles codepage
30 files for use with the internationalization features of
31 Samba 2.2
32 !!OPTIONS
33
34
35 __c|d__
36
37
38 This tells __make_smbcodepage__ if it is compiling
39 (''c'') a text format code page file to binary, or
40 (''d'') de-compiling a binary codepage file to
41 text.
42
43
44 __codepage__
45
46
47 This is the codepage we are processing (a number, e.g.
48 850).
49
50
51 __inputfile__
52
53
54 This is the input file to process. In the ''c'' case this
55 will be a text codepage definition file such as the ones
56 found in the Samba ''source/codepages'' directory. In the
57 ''d'' case this will be the binary format codepage
58 definition file normally found in the ''lib/codepages''
59 directory in the Samba install directory path.
60
61
62 __outputfile__
63
64
65 This is the output file to produce.
66 !!SAMBA CODEPAGE FILES
67
68
69 A text Samba codepage definition file is a description that
70 tells Samba how to map from upper to lower case for
71 characters greater than ascii 127 in the specified DOS code
72 page. Note that for certain DOS codepages (437 for example)
73 mapping from lower to upper case may be non-symmetrical. For
74 example, in code page 437 lower case a acute maps to a plain
75 upper case A when going from lower to upper case, but plain
76 upper case A maps to plain lower case a when lower casing a
77 character.
78
79
80 A binary Samba codepage definition file is a binary
81 representation of the same information, including a value
82 that specifies what codepage this file is
83 describing.
84
85
86 As Samba does not yet use UNICODE (current for Samba version
87 2.2) you must specify the client code page that your DOS and
88 Windows clients are using if you wish to have case
89 insensitivity done correctly for your particular language.
90 The default codepage Samba uses is 850 (Western European).
91 Text codepage definition sample files are provided in the
92 Samba distribution for codepages 437 (USA), 737 (Greek), 850
93 (Western European) 852 (MS-DOS Latin 2), 861 (Icelandic),
94 866 (Cyrillic), 932 (Kanji SJIS), 936 (Simplified Chinese),
95 949 (Hangul) and 950 (Traditional Chinese). Users are
96 encouraged to write text codepage definition files for their
97 own code pages and donate them to samba@samba.org. All
98 codepage files in the Samba ''source/codepages''
99 directory are compiled and installed when a __'make
100 install'__ command is issued there.
101
102
103 The client codepage used by the __smbd__ server is
104 configured using the __client code page__ parameter in
105 the __smb.conf__ file.
106 !!FILES
107
108
109 __codepage_def.__
110
111
112 These are the input (text) codepage files provided in the
113 Samba ''source/codepages'' directory.
114
115
116 A text codepage definition file consists of multiple lines
117 containing four fields. These fields are:
118
119
120 __lower__: which is the (hex) lower case character mapped
121 on this line.
122
123
124 __upper__: which is the (hex) upper case character that
125 the lower case character will map to.
126
127
128 __map upper to lower__ which is a boolean value (put
129 either True or False here) which tells Samba if it is to map
130 the given upper case character to the given lower case
131 character when lower casing a filename.
132
133
134 __map lower to upper__ which is a boolean value (put
135 either True or False here) which tells Samba if it is to map
136 the given lower case character to the given upper case
137 character when upper casing a filename.
138
139
140 __codepage.__ - These are the output
141 (binary) codepage files produced and placed in the Samba
142 destination ''lib/codepage'' directory.
143 !!INSTALLATION
144
145
146 The location of the server and its support files is a matter
147 for individual system administrators. The following are thus
148 suggestions only.
149
150
151 It is recommended that the __make_smbcodepage__ program
152 be installed under the ''/usr/local/samba'' hierarchy, in
153 a directory readable by all, writeable only by root. The
154 program itself should be executable by all. The program
155 should NOT be setuid or setgid!
156 !!VERSION
157
158
159 This man page is correct for version 2.2 of the Samba
160 suite.
161 !!SEE ALSO
162
163
164 __smbd(8)__, smb.conf(5)
165 !!AUTHOR
166
167
168 The original Samba software and related utilities were
169 created by Andrew Tridgell. Samba is now developed by the
170 Samba Team as an Open Source project similar to the way the
171 Linux kernel is developed.
172
173
174 The original Samba man pages were written by Karl Auer. The
175 man page sources were converted to YODL format (another
176 excellent piece of Open Source software, available at
177 ftp://ftp.icce.rug.nl/pub/unix/
178 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.