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