diff options
author | Gerald Carter <jerry@samba.org> | 2001-02-22 21:48:19 +0000 |
---|---|---|
committer | Gerald Carter <jerry@samba.org> | 2001-02-22 21:48:19 +0000 |
commit | cbf0f980c9cbc6ae3fd067c506e8062c4399d7b0 (patch) | |
tree | 089b85019d3266b7360d2563904e3aae6e3122c9 /docs/manpages/make_smbcodepage.1 | |
parent | 4bca9fd8d4c57c9bcd36c8ed9924a866540ddd65 (diff) | |
download | samba-cbf0f980c9cbc6ae3fd067c506e8062c4399d7b0.tar.gz samba-cbf0f980c9cbc6ae3fd067c506e8062c4399d7b0.tar.bz2 samba-cbf0f980c9cbc6ae3fd067c506e8062c4399d7b0.zip |
save as we go. More pages done.
(This used to be commit ec1dfb80b39f816faed702ace20a385aba9caf6b)
Diffstat (limited to 'docs/manpages/make_smbcodepage.1')
-rw-r--r-- | docs/manpages/make_smbcodepage.1 | 284 |
1 files changed, 140 insertions, 144 deletions
diff --git a/docs/manpages/make_smbcodepage.1 b/docs/manpages/make_smbcodepage.1 index e6c76d9855..502f9a5909 100644 --- a/docs/manpages/make_smbcodepage.1 +++ b/docs/manpages/make_smbcodepage.1 @@ -1,144 +1,140 @@ -.TH "make_smbcodepage " "1" "23 Oct 1998" "Samba" "SAMBA" -.PP -.SH "NAME" -make_codepage \- Construct a codepage file for Samba -.PP -.SH "SYNOPSIS" -.PP -\fBmake_smbcodepage\fP [c|d] codepage inputfile outputfile -.PP -.SH "DESCRIPTION" -.PP -This program is part of the \fBSamba\fP suite\&. -.PP -\fBmake_smbcodepage\fP compiles or de-compiles codepage files for use -with the internationalization features of Samba 2\&.0 -.PP -.SH "OPTIONS" -.PP -.IP -.IP "c|d" -This tells \fBmake_smbcodepage\fP if it is compiling (\fBc\fP) a text -format code page file to binary, or (\fBd\fP) de-compiling a binary codepage -file to text\&. -.IP -.IP "codepage" -This is the codepage we are processing (a number, e\&.g\&. 850)\&. -.IP -.IP "inputfile" -This is the input file to process\&. In the \'\fBc\fP\' case this -will be a text codepage definition file such as the ones found in the -Samba \fIsource/codepages\fP directory\&. In the \'\fBd\fP\' case this will be the -binary format codepage definition file normally found in the -\fIlib/codepages\fP directory in the Samba install directory path\&. -.IP -.IP "outputfile" -This is the output file to produce\&. -.IP -.PP -.SH "Samba Codepage Files" -.PP -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\&. -.PP -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\&. -.PP -As Samba does not yet use UNICODE (current for Samba version 2\&.0) 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 (Traditional Chinese)\&. Users are encouraged to write -text codepage definition files for their own code pages and donate -them to samba@samba\&.org\&. All codepage files in the -Samba \fIsource/codepages\fP directory are compiled and installed when a -\fI\'make install\'\fP command is issued there\&. -.PP -The client codepage used by the \fBsmbd\fP server is -configured using the \fBclient code -page\fP parameter in the -\fBsmb\&.conf\fP file\&. -.PP -.SH "FILES" -.PP -\fBcodepage_def\&.<codepage>\fP -.PP -These are the input (text) codepage files provided in the Samba -\fIsource/codepages\fP directory\&. -.PP -A text codepage definition file consists of multiple lines -containing four fields\&. These fields are : -.PP -.IP -.IP o -\fBlower\fP: which is the (hex) lower case character mapped on this -line\&. -.IP -.IP o -\fBupper\fP: which is the (hex) upper case character that the lower -case character will map to\&. -.IP -.IP o -\fBmap upper to lower\fP 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\&. -.IP -.IP o -\fBmap lower to upper\fP 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\&. -.IP -.PP -\fBcodepage\&.<codepage>\fP These are the output (binary) codepage files -produced and placed in the Samba destination \fIlib/codepage\fP -directory\&. -.PP -.SH "INSTALLATION" -.PP -The location of the server and its support files is a matter for -individual system administrators\&. The following are thus suggestions -only\&. -.PP -It is recommended that the \fBmake_smbcodepage\fP program be installed -under the \fI/usr/local/samba\fP 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! -.PP -.SH "VERSION" -.PP -This man page is correct for version 2\&.0 of the Samba suite\&. -.PP -.SH "SEE ALSO" -.PP -\fBsmb\&.conf(5)\fP, \fBsmbd (8)\fP -.PP -.SH "AUTHOR" -.PP -The original Samba software and related utilities were created by -Andrew Tridgell samba@samba\&.org\&. Samba is now developed -by the Samba Team as an Open Source project similar to the way the -Linux kernel is developed\&. -.PP -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 -\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP) -and updated for the Samba2\&.0 release by Jeremy Allison\&. -samba@samba\&.org\&. -.PP -See \fBsamba (7)\fP to find out how to get a full -list of contributors and details on how to submit bug reports, -comments etc\&. +.\" This manpage has been automatically generated by docbook2man-spec +.\" from a DocBook document. docbook2man-spec can be found at: +.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "MAKE_SMBCODEPAGE" "1" "22 February 2001" "" "" +.SH NAME +make_smbcodepage \- construct a codepage file for Samba +.SH SYNOPSIS +.sp +\fBmake_smbcodepage\fR \fBc|d\fR \fBcodepage\fR \fBinputfile\fR \fBoutputfile\fR +.SH "DESCRIPTION" +.PP +This tool is part of the Samba <URL:samba.7.html> suite. +.PP +\fBmake_smbcodepage\fR compiles or de-compiles +codepage files for use with the internationalization features +of Samba 2.2 +.SH "OPTIONS" +.TP +\fBc|d\fR +This tells \fBmake_smbcodepage\fR +if it is compiling (\fIc\fR) a text format code +page file to binary, or (\fId\fR) de-compiling +a binary codepage file to text. +.TP +\fBcodepage\fR +This is the codepage we are processing (a +number, e.g. 850). +.TP +\fBinputfile\fR +This is the input file to process. In t +he '\fIc\fR' case this will be a text +codepage definition file such as the ones found in the Samba +\fIsource/codepages\fR directory. In +the '\fId\fR' case this will be the +binary format codepage definition file normally found in +the \fIlib/codepages\fR directory in the +Samba install directory path. +.TP +\fBoutputfile\fR +This is the output file to produce. +.SH "SAMBA CODEPAGE FILES" +.PP +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. +.PP +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. +.PP +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 (Traditional +Chinese). Users are encouraged to write text codepage definition files for +their own code pages and donate them to samba@samba.org. All codepage files +in the Samba \fIsource/codepages\fR directory are +compiled and installed when a \fB'make install'\fR +command is issued there. +.PP +The client codepage used by the \fBsmbd\fR server +is configured using the \fBclient code page\fR parameter +in the \fBsmb.conf\fR file. +.SH "FILES" +.PP +\fBcodepage_def.<codepage>\fR +.PP +These are the input (text) codepage files provided in the +Samba \fIsource/codepages\fR directory. +.PP +A text codepage definition file consists of multiple lines +containing four fields. These fields are: +.TP 0.2i +\(bu +\fBlower\fR: which is the +(hex) lower case character mapped on this line. +.TP 0.2i +\(bu +\fBupper\fR: which is the (hex) +upper case character that the lower case character will map to. +.TP 0.2i +\(bu +\fBmap upper to lower\fR 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. +.TP 0.2i +\(bu +\fBmap lower to upper\fR 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. +.PP +\fBcodepage.<codepage>\fR - These are the +output (binary) codepage files produced and placed in the Samba +destination \fIlib/codepage\fR directory. +.PP +.SH "INSTALLATION" +.PP +The location of the server and its support files is a +matter for individual system administrators. The following are +thus suggestions only. +.PP +It is recommended that the \fBmake_smbcodepage +\fRprogram be installed under the \fI/usr/local/samba +\fRhierarchy, 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! +.SH "VERSION" +.PP +This man page is correct for version 2.2 of +the Samba suite. +.SH "SEE ALSO" +.PP +\fBsmbd(8)\fR <URL:smbd.8.html>, +smb.conf(5) <URL:smb.conf.5.html> +.SH "AUTHOR" +.PP +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. +.PP +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 |