summaryrefslogtreecommitdiff
path: root/docs/htmldocs/Samba3-HOWTO/unicode.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/Samba3-HOWTO/unicode.html')
-rw-r--r--docs/htmldocs/Samba3-HOWTO/unicode.html128
1 files changed, 64 insertions, 64 deletions
diff --git a/docs/htmldocs/Samba3-HOWTO/unicode.html b/docs/htmldocs/Samba3-HOWTO/unicode.html
index 05d180ea57..d7d83ad61a 100644
--- a/docs/htmldocs/Samba3-HOWTO/unicode.html
+++ b/docs/htmldocs/Samba3-HOWTO/unicode.html
@@ -1,5 +1,5 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 30. Unicode/Charsets</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The Official Samba 3.5.x HOWTO and Reference Guide"><link rel="up" href="optional.html" title="Part III. Advanced Configuration"><link rel="prev" href="integrate-ms-networks.html" title="Chapter 29. Integrating MS Windows Networks with Samba"><link rel="next" href="Backup.html" title="Chapter 31. Backup Techniques"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 30. Unicode/Charsets</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="integrate-ms-networks.html">Prev</a> </td><th width="60%" align="center">Part III. Advanced Configuration</th><td width="20%" align="right"> <a accesskey="n" href="Backup.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 30. Unicode/Charsets"><div class="titlepage"><div><div><h2 class="title"><a name="unicode"></a>Chapter 30. Unicode/Charsets</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Jelmer</span> <span class="othername">R.</span> <span class="surname">Vernooij</span></h3><div class="affiliation"><span class="orgname">The Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jelmer@samba.org">jelmer@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">TAKAHASHI</span> <span class="surname">Motonobu</span></h3><span class="contrib">Japanese character support</span> <div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:monyo@home.monyo.com">monyo@home.monyo.com</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">25 March 2003</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="unicode.html#id432542">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432588">What Are Charsets and Unicode?</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432707">Samba and Charsets</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432832">Conversion from Old Names</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432862">Japanese Charsets</a></span></dt><dd><dl><dt><span class="sect2"><a href="unicode.html#id432977">Basic Parameter Setting</a></span></dt><dt><span class="sect2"><a href="unicode.html#id433554">Individual Implementations</a></span></dt><dt><span class="sect2"><a href="unicode.html#id433668">Migration from Samba-2.2 Series</a></span></dt></dl></dd><dt><span class="sect1"><a href="unicode.html#id433807">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="unicode.html#id433812">CP850.so Can't Be Found</a></span></dt></dl></dd></dl></div><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432542"></a>Features and Benefits</h2></div></div></div><p>
-<a class="indexterm" name="id432550"></a>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 30. Unicode/Charsets</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The Official Samba 3.5.x HOWTO and Reference Guide"><link rel="up" href="optional.html" title="Part III. Advanced Configuration"><link rel="prev" href="integrate-ms-networks.html" title="Chapter 29. Integrating MS Windows Networks with Samba"><link rel="next" href="Backup.html" title="Chapter 31. Backup Techniques"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 30. Unicode/Charsets</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="integrate-ms-networks.html">Prev</a> </td><th width="60%" align="center">Part III. Advanced Configuration</th><td width="20%" align="right"> <a accesskey="n" href="Backup.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 30. Unicode/Charsets"><div class="titlepage"><div><div><h2 class="title"><a name="unicode"></a>Chapter 30. Unicode/Charsets</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Jelmer</span> <span class="othername">R.</span> <span class="surname">Vernooij</span></h3><div class="affiliation"><span class="orgname">The Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jelmer@samba.org">jelmer@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">TAKAHASHI</span> <span class="surname">Motonobu</span></h3><span class="contrib">Japanese character support</span> <div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:monyo@home.monyo.com">monyo@home.monyo.com</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">25 March 2003</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="unicode.html#id432528">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432573">What Are Charsets and Unicode?</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432692">Samba and Charsets</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432818">Conversion from Old Names</a></span></dt><dt><span class="sect1"><a href="unicode.html#id432847">Japanese Charsets</a></span></dt><dd><dl><dt><span class="sect2"><a href="unicode.html#id432968">Basic Parameter Setting</a></span></dt><dt><span class="sect2"><a href="unicode.html#id433545">Individual Implementations</a></span></dt><dt><span class="sect2"><a href="unicode.html#id433658">Migration from Samba-2.2 Series</a></span></dt></dl></dd><dt><span class="sect1"><a href="unicode.html#id433797">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="unicode.html#id433803">CP850.so Can't Be Found</a></span></dt></dl></dd></dl></div><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432528"></a>Features and Benefits</h2></div></div></div><p>
+<a class="indexterm" name="id432536"></a>
Every industry eventually matures. One of the great areas of maturation is in
the focus that has been given over the past decade to make it possible for anyone
anywhere to use a computer. It has not always been that way. In fact, not so long
@@ -11,19 +11,19 @@ language support for all computer users, the efforts of the
<a class="ulink" href="http://www.openi18n.org/" target="_top">Openi18n organization</a>
is deserving of special mention.
</p><p>
-<a class="indexterm" name="id432574"></a>
+<a class="indexterm" name="id432559"></a>
Samba-2.x supported a single locale through a mechanism called
<span class="emphasis"><em>codepages</em></span>. Samba-3 is destined to become a truly transglobal
file- and printer-sharing platform.
-</p></div><div class="sect1" title="What Are Charsets and Unicode?"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432588"></a>What Are Charsets and Unicode?</h2></div></div></div><p>
-<a class="indexterm" name="id432595"></a>
+</p></div><div class="sect1" title="What Are Charsets and Unicode?"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432573"></a>What Are Charsets and Unicode?</h2></div></div></div><p>
+<a class="indexterm" name="id432581"></a>
Computers communicate in numbers. In texts, each number is
translated to a corresponding letter. The meaning that will be assigned
to a certain number depends on the <span class="emphasis"><em>character set (charset)
</em></span> that is used.
</p><p>
-<a class="indexterm" name="id432611"></a>
-<a class="indexterm" name="id432618"></a>
+<a class="indexterm" name="id432597"></a>
+<a class="indexterm" name="id432603"></a>
A charset can be seen as a table that is used to translate numbers to
letters. Not all computers use the same charset (there are charsets
with German umlauts, Japanese characters, and so on). The American Standard Code
@@ -31,36 +31,36 @@ for Information Interchange (ASCII) encoding system has been the normative chara
encoding scheme used by computers to date. This employs a charset that contains
256 characters. Using this mode of encoding, each character takes exactly one byte.
</p><p>
-<a class="indexterm" name="id432632"></a>
-<a class="indexterm" name="id432639"></a>
+<a class="indexterm" name="id432618"></a>
+<a class="indexterm" name="id432624"></a>
There are also charsets that support extended characters, but those need at least
twice as much storage space as does ASCII encoding. Such charsets can contain
<code class="literal">256 * 256 = 65536</code> characters, which is more than all possible
characters one could think of. They are called multibyte charsets because they use
more then one byte to store one character.
</p><p>
-<a class="indexterm" name="id432657"></a>
+<a class="indexterm" name="id432643"></a>
One standardized multibyte charset encoding scheme is known as
<a class="ulink" href="http://www.unicode.org/" target="_top">unicode</a>. A big advantage of using a
multibyte charset is that you only need one. There is no need to make sure two
computers use the same charset when they are communicating.
</p><p>
+<a class="indexterm" name="id432661"></a>
+<a class="indexterm" name="id432668"></a>
<a class="indexterm" name="id432675"></a>
-<a class="indexterm" name="id432682"></a>
-<a class="indexterm" name="id432689"></a>
Old Windows clients use single-byte charsets, named
<em class="parameter"><code>codepages</code></em>, by Microsoft. However, there is no support for
negotiating the charset to be used in the SMB/CIFS protocol. Thus, you
have to make sure you are using the same charset when talking to an older client.
Newer clients (Windows NT, 200x, XP) talk Unicode over the wire.
-</p></div><div class="sect1" title="Samba and Charsets"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432707"></a>Samba and Charsets</h2></div></div></div><p>
-<a class="indexterm" name="id432714"></a>
-<a class="indexterm" name="id432721"></a>
+</p></div><div class="sect1" title="Samba and Charsets"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432692"></a>Samba and Charsets</h2></div></div></div><p>
+<a class="indexterm" name="id432700"></a>
+<a class="indexterm" name="id432707"></a>
As of Samba-3, Samba can (and will) talk Unicode over the wire. Internally,
Samba knows of three kinds of character sets:
</p><div class="variablelist"><dl><dt><span class="term"><a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a></span></dt><dd><p>
-<a class="indexterm" name="id432751"></a>
-<a class="indexterm" name="id432758"></a>
+<a class="indexterm" name="id432737"></a>
+<a class="indexterm" name="id432743"></a>
This is the charset used internally by your operating system.
The default is <code class="constant">UTF-8</code>, which is fine for most
systems and covers all characters in all languages. The default
@@ -73,26 +73,26 @@ Samba knows of three kinds of character sets:
The default depends on the charsets you have installed on your system.
Run <code class="literal">testparm -v | grep "dos charset"</code> to see
what the default is on your system.
- </p></dd></dl></div></div><div class="sect1" title="Conversion from Old Names"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432832"></a>Conversion from Old Names</h2></div></div></div><p>
-<a class="indexterm" name="id432840"></a>
+ </p></dd></dl></div></div><div class="sect1" title="Conversion from Old Names"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432818"></a>Conversion from Old Names</h2></div></div></div><p>
+<a class="indexterm" name="id432826"></a>
Because previous Samba versions did not do any charset conversion,
characters in filenames are usually not correct in the UNIX charset but only
for the local charset used by the DOS/Windows clients.
</p><p>Bjoern Jacke has written a utility named <a class="ulink" href="http://j3e.de/linux/convmv/" target="_top">convmv</a>
that can convert whole directory structures to different charsets with one single command.
-</p></div><div class="sect1" title="Japanese Charsets"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432862"></a>Japanese Charsets</h2></div></div></div><p>
+</p></div><div class="sect1" title="Japanese Charsets"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id432847"></a>Japanese Charsets</h2></div></div></div><p>
Setting up Japanese charsets is quite difficult. This is mainly because:
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
-<a class="indexterm" name="id432876"></a>
+<a class="indexterm" name="id432862"></a>
The Windows character set is extended from the original legacy Japanese
standard (JIS X 0208) and is not standardized. This means that the strictly
standardized implementation cannot support the full Windows character set.
</p></li><li class="listitem"><p>
-<a class="indexterm" name="id432890"></a>
+<a class="indexterm" name="id432875"></a>
+<a class="indexterm" name="id432882"></a>
+<a class="indexterm" name="id432889"></a>
<a class="indexterm" name="id432896"></a>
-<a class="indexterm" name="id432903"></a>
-<a class="indexterm" name="id432910"></a>
-<a class="indexterm" name="id432917"></a>
+<a class="indexterm" name="id432902"></a>
Mainly for historical reasons, there are several encoding methods in
Japanese, which are not fully compatible with each other. There are
two major encoding methods. One is the Shift_JIS series used in Windows
@@ -112,24 +112,24 @@ Setting up Japanese charsets is quite difficult. This is mainly because:
names may be different on different systems. This means that the value of
the charset parameters depends on the implementation of iconv() you are using.
</p><p>
-<a class="indexterm" name="id432946"></a>
-<a class="indexterm" name="id432953"></a>
-<a class="indexterm" name="id432960"></a>
-<a class="indexterm" name="id432966"></a>
+<a class="indexterm" name="id432936"></a>
+<a class="indexterm" name="id432943"></a>
+<a class="indexterm" name="id432950"></a>
+<a class="indexterm" name="id432957"></a>
Though 2-byte fixed UCS-2 encoding is used in Windows internally,
Shift_JIS series encoding is usually used in Japanese environments
as ASCII encoding is in English environments.
- </p></li></ul></div><div class="sect2" title="Basic Parameter Setting"><div class="titlepage"><div><div><h3 class="title"><a name="id432977"></a>Basic Parameter Setting</h3></div></div></div><p>
-<a class="indexterm" name="id432984"></a>
+ </p></li></ul></div><div class="sect2" title="Basic Parameter Setting"><div class="titlepage"><div><div><h3 class="title"><a name="id432968"></a>Basic Parameter Setting</h3></div></div></div><p>
+<a class="indexterm" name="id432974"></a>
The <a class="link" href="smb.conf.5.html#DOSCHARSET" target="_top">dos charset</a> and
<a class="link" href="smb.conf.5.html#DISPLAYCHARSET" target="_top">display charset</a>
should be set to the locale compatible with the character set
and encoding method used on Windows. This is usually CP932
but sometimes has a different name.
</p><p>
-<a class="indexterm" name="id433017"></a>
-<a class="indexterm" name="id433024"></a>
-<a class="indexterm" name="id433031"></a>
+<a class="indexterm" name="id433008"></a>
+<a class="indexterm" name="id433014"></a>
+<a class="indexterm" name="id433021"></a>
The <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a> can be either Shift_JIS series,
EUC-JP series, or UTF-8. UTF-8 is always available, but the availability of other locales
and the name itself depends on the system.
@@ -166,8 +166,8 @@ Setting up Japanese charsets is quite difficult. This is mainly because:
only. It is good practice to verify that the Japanized free software can work
with Shift_JIS.
</p></dd><dt><span class="term">EUC-JP series</span></dt><dd><p>
-<a class="indexterm" name="id433147"></a>
-<a class="indexterm" name="id433154"></a>
+<a class="indexterm" name="id433138"></a>
+<a class="indexterm" name="id433145"></a>
EUC-JP series means a locale that is equivalent to the industry
standard called EUC-JP, widely used in Japanese UNIX (although EUC
contains specifications for languages other than Japanese, such as
@@ -176,16 +176,16 @@ Setting up Japanese charsets is quite difficult. This is mainly because:
Windows on Samba, the filename on UNIX becomes 0xb6a6, 0xcdad,
<span class="quote">&#8220;<span class="quote">.txt</span>&#8221;</span> (an 8-byte BINARY string).
</p><p>
-<a class="indexterm" name="id433175"></a>
-<a class="indexterm" name="id433182"></a>
-<a class="indexterm" name="id433189"></a>
-<a class="indexterm" name="id433196"></a>
-<a class="indexterm" name="id433202"></a>
-<a class="indexterm" name="id433209"></a>
-<a class="indexterm" name="id433216"></a>
-<a class="indexterm" name="id433223"></a>
-<a class="indexterm" name="id433230"></a>
-<a class="indexterm" name="id433236"></a>
+<a class="indexterm" name="id433166"></a>
+<a class="indexterm" name="id433172"></a>
+<a class="indexterm" name="id433179"></a>
+<a class="indexterm" name="id433186"></a>
+<a class="indexterm" name="id433193"></a>
+<a class="indexterm" name="id433200"></a>
+<a class="indexterm" name="id433206"></a>
+<a class="indexterm" name="id433213"></a>
+<a class="indexterm" name="id433220"></a>
+<a class="indexterm" name="id433227"></a>
Since EUC-JP is usually used on open source UNIX, Linux, and FreeBSD, and on commercial-based UNIX, Solaris,
IRIX, and Tru64 UNIX as Japanese locale (however, it is also possible on Solaris to use Shift_JIS and UTF-8,
and on Tru64 UNIX it is possible to use Shift_JIS). To use EUC-JP series, most Japanese filenames created from
@@ -198,7 +198,7 @@ Setting up Japanese charsets is quite difficult. This is mainly because:
commands that cannot handle non-ASCII filenames may be aborted
during parsing filenames.
</p><p>
-<a class="indexterm" name="id433263"></a>
+<a class="indexterm" name="id433254"></a>
Moreover, if you built Samba using differently installed libiconv,
the eucJP-ms locale included in libiconv and EUC-JP series locale
included in the operating system may not be compatible. In this case, you may need to
@@ -223,24 +223,24 @@ Setting up Japanese charsets is quite difficult. This is mainly because:
must be handled carefully, so you had better not touch filenames
written from Windows on UNIX.
</p><p>
-<a class="indexterm" name="id433324"></a>
-<a class="indexterm" name="id433330"></a>
-<a class="indexterm" name="id433337"></a>
+<a class="indexterm" name="id433314"></a>
+<a class="indexterm" name="id433321"></a>
+<a class="indexterm" name="id433328"></a>
In addition, although it is not directly concerned with Samba, since
there is a delicate difference between the iconv() function, which is
generally used on UNIX, and the functions used on other platforms,
- such as Windows and Java, so far is concerens the conversion between
+ such as Windows and Java, so far is concerns the conversion between
Shift_JIS and Unicode UTF-8 must be done with care and recognition
of the limitations involved in the process.
</p><p>
-<a class="indexterm" name="id433351"></a>
+<a class="indexterm" name="id433341"></a>
Although Mac OS X uses UTF-8 as its encoding method for filenames,
it uses an extended UTF-8 specification that Samba cannot handle, so
UTF-8 locale is not available for Mac OS X.
</p></dd><dt><span class="term">Shift_JIS series + vfs_cap (CAP encoding)</span></dt><dd><p>
-<a class="indexterm" name="id433371"></a>
-<a class="indexterm" name="id433377"></a>
-<a class="indexterm" name="id433384"></a>
+<a class="indexterm" name="id433361"></a>
+<a class="indexterm" name="id433367"></a>
+<a class="indexterm" name="id433374"></a>
CAP encoding means a specification used in CAP and NetAtalk, file
server software for Macintosh. In the case of CAP encoding, for
example, if a Japanese filename consists of 0x8ba4 and 0x974c, and
@@ -269,14 +269,14 @@ Setting up Japanese charsets is quite difficult. This is mainly because:
</p><p>
To use CAP encoding on Samba-3, you should use the unix charset parameter and VFS
as in <a class="link" href="unicode.html#vfscap-intl" title="Example 30.1. VFS CAP">the VFS CAP smb.conf file</a>.
- </p><div class="example"><a name="vfscap-intl"></a><p class="title"><b>Example 30.1. VFS CAP</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td># the locale name "CP932" may be different</td></tr><tr><td><a class="indexterm" name="id433470"></a><em class="parameter"><code>dos charset = CP932</code></em></td></tr><tr><td><a class="indexterm" name="id433482"></a><em class="parameter"><code>unix charset = CP932</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[cap-share]</code></em></td></tr><tr><td><a class="indexterm" name="id433502"></a><em class="parameter"><code>vfs option = cap</code></em></td></tr></table></div></div><br class="example-break"><p>
-<a class="indexterm" name="id433517"></a>
-<a class="indexterm" name="id433524"></a>
-<a class="indexterm" name="id433530"></a>
-<a class="indexterm" name="id433537"></a>
+ </p><div class="example"><a name="vfscap-intl"></a><p class="title"><b>Example 30.1. VFS CAP</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td># the locale name "CP932" may be different</td></tr><tr><td><a class="indexterm" name="id433460"></a><em class="parameter"><code>dos charset = CP932</code></em></td></tr><tr><td><a class="indexterm" name="id433472"></a><em class="parameter"><code>unix charset = CP932</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[cap-share]</code></em></td></tr><tr><td><a class="indexterm" name="id433492"></a><em class="parameter"><code>vfs option = cap</code></em></td></tr></table></div></div><br class="example-break"><p>
+<a class="indexterm" name="id433507"></a>
+<a class="indexterm" name="id433514"></a>
+<a class="indexterm" name="id433521"></a>
+<a class="indexterm" name="id433527"></a>
You should set CP932 if using GNU libiconv for unix charset. With this setting,
filenames in the <span class="quote">&#8220;<span class="quote">cap-share</span>&#8221;</span> share are written with CAP encoding.
- </p></dd></dl></div></div><div class="sect2" title="Individual Implementations"><div class="titlepage"><div><div><h3 class="title"><a name="id433554"></a>Individual Implementations</h3></div></div></div><p>
+ </p></dd></dl></div></div><div class="sect2" title="Individual Implementations"><div class="titlepage"><div><div><h3 class="title"><a name="id433545"></a>Individual Implementations</h3></div></div></div><p>
Here is some additional information regarding individual implementations:
</p><div class="variablelist"><dl><dt><span class="term">GNU libiconv</span></dt><dd><p>
To handle Japanese correctly, you should apply the patch
@@ -299,15 +299,15 @@ display charset = CP932
to glibc-2.2.5/2.3.1/2.3.2 or should use the patch-merged versions, glibc-2.3.3 or later.
</p><p>
Using the above glibc, these setting are available:
- </p><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id433623"></a><em class="parameter"><code>dos charset = CP932</code></em></td></tr><tr><td><a class="indexterm" name="id433635"></a><em class="parameter"><code>unix charset = CP932 / eucJP-ms / UTF-8</code></em></td></tr><tr><td><a class="indexterm" name="id433646"></a><em class="parameter"><code>display charset = CP932</code></em></td></tr></table><p>
+ </p><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id433613"></a><em class="parameter"><code>dos charset = CP932</code></em></td></tr><tr><td><a class="indexterm" name="id433625"></a><em class="parameter"><code>unix charset = CP932 / eucJP-ms / UTF-8</code></em></td></tr><tr><td><a class="indexterm" name="id433636"></a><em class="parameter"><code>display charset = CP932</code></em></td></tr></table><p>
</p><p>
Other Japanese locales (for example, Shift_JIS and EUC-JP) should not
be used because of the lack of the compatibility with Windows.
- </p></dd></dl></div></div><div class="sect2" title="Migration from Samba-2.2 Series"><div class="titlepage"><div><div><h3 class="title"><a name="id433668"></a>Migration from Samba-2.2 Series</h3></div></div></div><p>
+ </p></dd></dl></div></div><div class="sect2" title="Migration from Samba-2.2 Series"><div class="titlepage"><div><div><h3 class="title"><a name="id433658"></a>Migration from Samba-2.2 Series</h3></div></div></div><p>
Prior to Samba-2.2 series, the <span class="quote">&#8220;<span class="quote">coding system</span>&#8221;</span> parameter was used. The default codepage in Samba
2.x was code page 850. In the Samba-3 series this has been replaced with the <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a> parameter. <a class="link" href="unicode.html#japancharsets" title="Table 30.1. Japanese Character Sets in Samba-2.2 and Samba-3">Japanese Character Sets in Samba-2.2 and Samba-3</a>
shows the mapping table when migrating from the Samba-2.2 series to Samba-3.
-</p><div class="table"><a name="japancharsets"></a><p class="title"><b>Table 30.1. Japanese Character Sets in Samba-2.2 and Samba-3</b></p><div class="table-contents"><table summary="Japanese Character Sets in Samba-2.2 and Samba-3" border="1"><colgroup><col align="center"><col align="center"></colgroup><thead><tr><th align="center">Samba-2.2 Coding System</th><th align="center">Samba-3 unix charset</th></tr></thead><tbody><tr><td align="center">SJIS</td><td align="center">Shift_JIS series</td></tr><tr><td align="center">EUC</td><td align="center">EUC-JP series</td></tr><tr><td align="center">EUC3<sup>[<a name="id433757" href="#ftn.id433757" class="footnote">a</a>]</sup></td><td align="center">EUC-JP series</td></tr><tr><td align="center">CAP</td><td align="center">Shift_JIS series + VFS</td></tr><tr><td align="center">HEX</td><td align="center">currently none</td></tr><tr><td align="center">UTF8</td><td align="center">UTF-8</td></tr><tr><td align="center">UTF8-Mac<sup>[<a name="id433788" href="#ftn.id433788" class="footnote">b</a>]</sup></td><td align="center">currently none</td></tr><tr><td align="center">others</td><td align="center">none</td></tr></tbody><tbody class="footnotes"><tr><td colspan="2"><div class="footnote"><p><sup>[<a name="ftn.id433757" href="#id433757" class="para">a</a>] </sup>Only exists in Japanese Samba version</p></div><div class="footnote"><p><sup>[<a name="ftn.id433788" href="#id433788" class="para">b</a>] </sup>Only exists in Japanese Samba version</p></div></td></tr></tbody></table></div></div><br class="table-break"></div></div><div class="sect1" title="Common Errors"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id433807"></a>Common Errors</h2></div></div></div><div class="sect2" title="CP850.so Can't Be Found"><div class="titlepage"><div><div><h3 class="title"><a name="id433812"></a>CP850.so Can't Be Found</h3></div></div></div><p><span class="quote">&#8220;<span class="quote">Samba is complaining about a missing <code class="filename">CP850.so</code> file.</span>&#8221;</span></p><p>
+</p><div class="table"><a name="japancharsets"></a><p class="title"><b>Table 30.1. Japanese Character Sets in Samba-2.2 and Samba-3</b></p><div class="table-contents"><table summary="Japanese Character Sets in Samba-2.2 and Samba-3" border="1"><colgroup><col align="center"><col align="center"></colgroup><thead><tr><th align="center">Samba-2.2 Coding System</th><th align="center">Samba-3 unix charset</th></tr></thead><tbody><tr><td align="center">SJIS</td><td align="center">Shift_JIS series</td></tr><tr><td align="center">EUC</td><td align="center">EUC-JP series</td></tr><tr><td align="center">EUC3<sup>[<a name="id433747" href="#ftn.id433747" class="footnote">a</a>]</sup></td><td align="center">EUC-JP series</td></tr><tr><td align="center">CAP</td><td align="center">Shift_JIS series + VFS</td></tr><tr><td align="center">HEX</td><td align="center">currently none</td></tr><tr><td align="center">UTF8</td><td align="center">UTF-8</td></tr><tr><td align="center">UTF8-Mac<sup>[<a name="id433778" href="#ftn.id433778" class="footnote">b</a>]</sup></td><td align="center">currently none</td></tr><tr><td align="center">others</td><td align="center">none</td></tr></tbody><tbody class="footnotes"><tr><td colspan="2"><div class="footnote"><p><sup>[<a name="ftn.id433747" href="#id433747" class="para">a</a>] </sup>Only exists in Japanese Samba version</p></div><div class="footnote"><p><sup>[<a name="ftn.id433778" href="#id433778" class="para">b</a>] </sup>Only exists in Japanese Samba version</p></div></td></tr></tbody></table></div></div><br class="table-break"></div></div><div class="sect1" title="Common Errors"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id433797"></a>Common Errors</h2></div></div></div><div class="sect2" title="CP850.so Can't Be Found"><div class="titlepage"><div><div><h3 class="title"><a name="id433803"></a>CP850.so Can't Be Found</h3></div></div></div><p><span class="quote">&#8220;<span class="quote">Samba is complaining about a missing <code class="filename">CP850.so</code> file.</span>&#8221;</span></p><p>
CP850 is the default <a class="link" href="smb.conf.5.html#DOSCHARSET" target="_top">dos charset</a>.
The <a class="link" href="smb.conf.5.html#DOSCHARSET" target="_top">dos charset</a> is used to convert data to the codepage used by your DOS clients.
If you do not have any DOS clients, you can safely ignore this message. </p><p>