MAKE_SMBCODEPAGE(1U)NIX System V (19	November 200M2A)KE_SMBCODEPAGE(1)



     NAME    [Toc]    [Back]
	  make_smbcodepage - construct a codepage file for Samba

     SYNOPSIS    [Toc]    [Back]
	  make_smbcodepage c|d codepage	inputfile outputfile

     DESCRIPTION    [Toc]    [Back]
	  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    [Toc]    [Back]
	  c|d  This tells make_smbcodepage if it is compiling (c) a
	       text format code	page file to binary, or	(d) decompiling
 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    [Toc]    [Back]
	  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).



     Page 1					     (printed 2/13/04)






     MAKE_SMBCODEPAGE(1U)NIX System V (19	November 200M2A)KE_SMBCODEPAGE(1)



	  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 [email protected]. 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    [Toc]    [Back]
	  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:

	  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 character 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 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    [Toc]    [Back]
	  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



     Page 2					     (printed 2/13/04)






     MAKE_SMBCODEPAGE(1U)NIX System V (19	November 200M2A)KE_SMBCODEPAGE(1)



	  should NOT be	setuid or setgid!

     VERSION    [Toc]    [Back]
	  This man page	is correct for version 2.2 of the Samba	suite.

     SEE ALSO    [Toc]    [Back]
	  smbd(8) smb.conf(5)

     AUTHOR    [Toc]    [Back]
	  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
	  ftp://ftp.icce.rug.nl/pub/unix/
	  <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the
	  Samba	2.0 release by Jeremy Allison. The conversion to
	  DocBook for Samba 2.2	was done by Gerald Carter


































     Page 3					     (printed 2/13/04)