Changeset f7cf1fb for chapter08/fstab.xml

Timestamp:

05/16/2018 08:54:19 PM (6 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

9901037e

Parents:

3cb1f96

Message:

Provide better i18n instructions to setting up /etc/fstab.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11411 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:

• chapter08/fstab.xml (modified) (2 diffs)

chapter08/fstab.xml

@@ -57 +57 @@
   fields in this file, see <command>man 5 fstab</command>.</para>
 
-  <para>Filesystems with MS-DOS or Windows origin (i.e.: vfat, ntfs, smbfs, cifs,
-  iso9660, udf) need the <quote>iocharset</quote> mount option in order for
-  non-ASCII characters in file names to be interpreted properly. The value
-  of this option should be the same as the character set of your locale,
-  adjusted in such a way that the kernel understands it. This works if the
-  relevant character set definition (found under File systems -&gt;
-  Native Language Support) has been compiled into the kernel
-  or built as a module. The <quote>codepage</quote> option is also needed for
-  vfat and smbfs filesystems. It should be set to the codepage number used
-  under MS-DOS in your country. E.g., in order to mount USB flash drives, a
-  ru_RU.KOI8-R user would need the following in the options portion of its
-  mount line in <filename>/etc/fstab</filename>:</para>
+  <para>Filesystems with MS-DOS or Windows origin (i.e. vfat, ntfs, smbfs,
+  cifs, iso9660, udf) need a special option, utf8, in order for non-ASCII
+  characters in file names to be interpreted properly. For non-UTF-8 locales,
+  the value of <option>iocharset</option> should be set to be the same as the
+  character set of the locale, adjusted in such a way that the kernel
+  understands it.  This works if the relevant character set definition (found
+  under File systems -&gt; Native Language Support when configuring the kernel)
+  has been compiled into the kernel or built as a module. However, if the
+  character set of the locale is UTF-8, the corresponding option
+  <option>iocharset=utf8</option> would make the file system case sensitive. To
+  fix this, use the special option <option>utf8</option> instead of
+  <option>iocharset=utf8</option>, for UTF-8 locales. The
+  <quote>codepage</quote> option is also needed for vfat and smbfs filesystems.
+  It should be set to the codepage number used under MS-DOS in your country.
+  For example, in order to mount USB flash drives, a ru_RU.KOI8-R user would
+  need the following in the options portion of its mount line in
+  <filename>/etc/fstab</filename>:</para>
 
-<screen><literal>noauto,user,quiet,showexec,iocharset=koi8r,codepage=866</literal></screen>
+<screen><literal>noauto,user,quiet,showexec,codepage=866,iocharset=koi8r</literal></screen>
 
   <para>The corresponding options fragment for ru_RU.UTF-8 users is:</para>
 
-<screen><literal>noauto,user,quiet,showexec,iocharset=utf8,codepage=866</literal></screen>
+<screen><literal>noauto,user,quiet,showexec,codepage=866,utf8</literal></screen>
 
-  <note>
+  <para>Note that using <option>iocharset</option> is the default for
+  <literal>iso8859-1</literal> (which keeps the file system case
+  insensitive), and the <option>utf8</option> option tells
+  the kernel to convert the file names using UTF-8 so they can be
+  interpreted in the UTF-8 locale.</para>
+
+  <!--note>
     <para>In the latter case, the kernel emits the following message:</para>
 
@@ -85 +96 @@
     of the <quote>iocharset</quote> option result in wrong display of filenames in
     UTF-8 locales.</para>
-  </note>
+  </note-->
 
   <para>It is also possible to specify default codepage and iocharset values for