docs/htmldocs/make_smbcodepage.1.html

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