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