## 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-sym
           metrical. 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 repre
           sentation  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  ver
           sion  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
           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)  code
           page  files  produced  and placed in the Samba destination
           lib/codepage directory.

## INSTALLATION

           The location of the server and its support files is a mat
           ter  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)

## AUTHOR

           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.