MAKE_SMBCODEPAGE(1)                                        MAKE_SMBCODEPAGE(1)

       make_smbcodepage - construct a codepage file for Samba

       make_smbcodepage c|d codepage inputfile outputfile

       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

       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.

              This is the codepage we are processing (a number, e.g. 850).

              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.

              This is the output file to produce.

       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  code-
       pages  (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 (Tradi-
       tional Chinese). Users are encouraged to write text codepage definition
       files  for their own code pages and donate them to 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.


       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:

       o lower: which is the (hex) lower case character mapped on this line.

       o upper: which is the (hex) upper case character that  the  lower  case
         character will map to.

       o 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  charac-
         ter to the given lower case character when lower casing a filename.

       o 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  charac-
         ter to the given upper case character when upper casing a filename.

       codepage.<codepage> - These are the output (binary) codepage files pro-
       duced and placed in the Samba destination lib/codepage directory.

       The location of the server and its support files is a matter for  indi-
       vidual  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, write-
       able only by root. The program itself should be executable by all.  The
       program should NOT be setuid or setgid!

       This man page is correct for version 2.2 of the Samba suite.

       smbd(8) smb.conf(5)

       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.

       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
       <URL:>) and updated for  the  Samba  2.0
       release  by Jeremy Allison. The conversion to DocBook for Samba 2.2 was
       done by Gerald Carter

                               19 November 2002            MAKE_SMBCODEPAGE(1)