make_smbcodepage 中文man頁(yè)面
名字
make_smbcodepage - 為Samba創(chuàng)建代碼頁(yè)文件
總覽
make_smbcodepage c|d 代碼頁(yè) 輸入文件 輸出文件
描述
這個(gè)工具是是Samba組件的一部分。
針對(duì)Samba 2.2的國(guó)際化功能，使用make_smbcodepage可以編譯或反編譯代碼頁(yè)文件。
選項(xiàng)
- c|d
- 使用c把一個(gè)文本格式的代碼頁(yè)文件編譯成二進(jìn)制格式；使用d把一個(gè)二進(jìn)制格式的代碼頁(yè)反編譯成文本格式。
- 代碼頁(yè)
- 選用的代碼頁(yè)(一個(gè)數(shù)字，如850)。
- 輸入文件
- 待處理的輸入文件。在使用c選項(xiàng)時(shí)，它是文本格式的代碼頁(yè)預(yù)定義文件，這些文件可以在Samba包的source/codepages 目錄中找到；在使用d選項(xiàng)時(shí)，它是二進(jìn)制格式的代碼頁(yè)文件，通常，這些文件保存在Samba安裝路徑的lib/codepages目錄的。
- 輸出文件
- 程序產(chǎn)生的輸出文件。
Samba的代碼頁(yè)文件
文本格式的代碼頁(yè)定義文件描述了在指定DOS代碼頁(yè)大于127的字符中是如何把大寫轉(zhuǎn)換為小寫的。要注意的是，在某些DOS代碼頁(yè)中 (如437)，大小寫之間的映射并不一定對(duì)稱。例如，在代碼頁(yè)437中，當(dāng)進(jìn)行小寫到大寫的映射時(shí)，把帶有撇形(＇)重音符號(hào)的a轉(zhuǎn)換為不帶重間符號(hào)的明文大寫字母A，而當(dāng)進(jìn)行大寫到小寫映射時(shí)，則把字母A直接轉(zhuǎn)換為字母a而不帶重間符號(hào)。
而二進(jìn)制代碼頁(yè)定義文件則是相同信息的二進(jìn)制表示，同時(shí)包含一個(gè)值，用來(lái)說(shuō)明所描述的代碼頁(yè)。
因?yàn)镾amba還沒有使用UNICODE碼，所以如果你希望在特殊的語(yǔ)言環(huán)境中不區(qū)分大小寫的話，就要為DOS和Windows客戶端指定所用的代碼頁(yè)。 Samba所用的缺省代碼頁(yè)是850(西歐語(yǔ))。同時(shí)，Samba發(fā)布還提供了文本格式的樣本代碼頁(yè)文件，包含437(美語(yǔ))、737(希臘語(yǔ))、850(西歐語(yǔ))、852(MS-DOS 拉丁2)、861(冰島語(yǔ)), 866 (斯拉夫語(yǔ))、932 (日語(yǔ))、936(簡(jiǎn)體中文)、949(韓文)和950(繁體中文)。我們鼓勵(lì)用戶為自己的代碼頁(yè)編寫文本格式的定義文件，并把它捐款給samba@samba.org。當(dāng)你執(zhí)行'make install'命令時(shí)，source/codepages目錄中的所有代碼頁(yè)文件都會(huì)被編譯并安裝到系統(tǒng)上。
在smb.conf文件中配置了client code page選項(xiàng)之后， smbd服務(wù)器就可以使用客戶代碼頁(yè)了。
相關(guān)文件
codepage_def.<codepage>
這是Samba源代碼包提供的用于輸入的文本代碼頁(yè)文件，它們保存在 source/codepages目錄中。
在這些文本格式的代碼頁(yè)定義文件中，每一行都包含了四個(gè)字段：
- *
- lower：小寫字符的十六進(jìn)制值。
- *
- upper：上述小寫字符所對(duì)應(yīng)的大寫字符十六進(jìn)制值。
- *
- map upper to lower：這是個(gè)布爾量(True或False二者選一)。用來(lái)說(shuō)明在對(duì)一個(gè)文件名進(jìn)行小寫處理時(shí)，是否讓Samba將其中的大寫字符映射成小寫字符。
- *
- map lower to upper：這是個(gè)布爾量(True或False二者選一)。用來(lái)說(shuō)明在對(duì)一個(gè)文件名進(jìn)行大寫處理時(shí)，是否讓Samba將其中的小寫字符映射成大寫字符。
codepage.<codepage> 這是Samba產(chǎn)生的輸出二進(jìn)制代碼頁(yè)文件，它們保存在Samba安裝目錄的 lib/codepage中。
安裝
服務(wù)器及相關(guān)支持文件的保存位置決定于系統(tǒng)管理員，以下只是建議：
我們推薦把make_smbcodepage程序安裝到/usr/local/samba 路徑下的一個(gè)目錄中，這個(gè)目錄應(yīng)該具有只有root可寫，所有人都可讀的權(quán)限。這個(gè)程序本身應(yīng)該讓所有用戶都可執(zhí)行，而不應(yīng)該執(zhí)行suid或sgid 操作。
版本
本手冊(cè)頁(yè)是針對(duì)samba 2.2版的。
另見
smbd(8)、smb.conf(5)
#p#
NAME
make_smbcodepage - construct a codepage file for Samba
SYNOPSIS
make_smbcodepage c|d codepage inputfile outputfile
DESCRIPTION
This tool is part of the Samba suite.
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-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 information, 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 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) codepage files produced and placed in the Samba destination lib/codepage directory.
INSTALLATION
The location of the server and its support files is a matter 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!
VERSION
This man page is correct for version 2.2 of the Samba suite.
SEE ALSO
smbd(8) smb.conf(5)
