Changeset 084c251

Timestamp:

11/17/2021 03:39:45 AM (2 years ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

6fa16a5

Parents:

7fa5ff6

Message:

resurrect ntfs-3g, and mention the new in-kernel NTFS impl

The tools (like mkfs.ntfs) is still useful, and one may be puzzled if he
uses:

mount /dev/sdb1 /mnt

Then mount will find out that /dev/sdb1 is NTFS, and use the *old*
NTFS support (read-only) in kernel for it. The user will then be
puzzled. Mention how to create a wrapper script for mount to use the
new NTFS3 driver for ntfs.

Files:

• introduction/welcome/changelog.xml (modified) (1 diff)
• postlfs/filesystems/filesystems.xml (modified) (1 diff)
• postlfs/filesystems/ntfs-3g.xml (moved) (moved from archive/ntfs-3g.xml ) (3 diffs)

introduction/welcome/changelog.xml

@@ -46 +46 @@
       <itemizedlist>
         <listitem>
+          <para>[xry111] - Add back ntfs-3g because the utilities in it
+          is still useful.  Mention the new in-kernel NTFS implementation
+          in the page.</para>
+        </listitem>
+        <listitem>
           <para>[bdubbs] - Update to git-2.34.0. Fixes
           <ulink url="&blfs-ticket-root;15754">#15754</ulink>.</para>

postlfs/filesystems/filesystems.xml

@@ -30 +30 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="aboutraid.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mdadm.xml"/>
-<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ntfs-3g.xml"/> -->
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ntfs-3g.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gptfdisk.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="parted.xml"/>

postlfs/filesystems/ntfs-3g.xml

@@ -29 +29 @@
   <sect2 role="package">
     <title>Introduction to Ntfs-3g</title>
+
+    <note>
+      <para id='ntfs3-kernel'>
+        A new read-write support for NTFS, called NTFS3, has been added
+        into Linux kernel since the 5.14 release.  The performance of NTFS3
+        is much better than ntfs-3g. To enable NTFS3, enable the following
+        options in the kernel configuration and recompile the kernel if
+        necessary:
+      </para>
+
+<screen><literal>File systems  ---&gt;
+  &lt;*/M&gt; NTFS Read-Write file system support [CONFIG_NTFS3_FS]</literal></screen>
+
+    <indexterm zone="ntfs-3g ntfs3-kernel">
+      <primary sortas="d-ntfs3">NTFS read-write support in kernel</primary>
+    </indexterm>
+
+      <para>
+        To ensure the <command>mount</command> command to use NTFS3 for
+        ntfs partitions, create a wrapper script:
+      </para>
+
+<screen role="nodump"><userinput>cat &gt;&gt; /usr/sbin/mount.ntfs &lt;&lt;"EOF" &amp;&amp;
+<literal>#!/bin/sh
+exec mount -t ntfs3 "$@"</literal>
+EOF
+chmod -v 755 /usr/sbin/mount.ntfs</userinput></screen>
+
+      <para>
+        With the kernel support available, ntfs-3g is only needed if you
+        need the utilities from it (for example, to create NTFS
+        filesystems).
+      </para>
+    </note>
 
     <para>
@@ -136 +170 @@
     </para>
 
-<screen role="root"><userinput>make install &amp;&amp;
-ln -sv ../bin/ntfs-3g /usr/sbin/mount.ntfs &amp;&amp;
+<screen role="root"><userinput>make install &amp;&amp;</userinput></screen>
+
+    <para>
+      It's recommended to use the in-kernel NTFS3 driver for mounting
+      NTFS filesystems, instead of ntfs-3g (see the note at the start of
+      this page).  However, if you want to use ntfs-3g to mount the NTFS
+      filesystems anyway, create a symlink for <command>mount</command>
+      command:
+    </para>
+
+<screen role="nodump"><userinput>ln -sv ../bin/ntfs-3g /usr/sbin/mount.ntfs &amp;&amp;
 ln -sv ntfs-3g.8 /usr/share/man/man8/mount.ntfs.8</userinput></screen>
-
-    <para>
-      If you want ordinary users to be able to mount NTFS partitions you'll need
-      to set mount.ntfs with the root user ID. Note: it is probably unsafe to do
-      this on a computer that needs to be secure (like a server). As the
-      <systemitem class="username">root</systemitem> user:
-    </para>
-
-<screen role="root"><userinput>chmod -v 4755 /usr/bin/ntfs-3g</userinput></screen>
 
   </sect2>
@@ -174 +208 @@
       <option>--disable-ntfsprogs</option>: Disables installation of various
       utilities used to manipulate NTFS partitions.
-    </para>
-
-    <para>
-      <command>ln -sv ../bin/ntfs-3g /usr/sbin/mount.ntfs</command>: Creating
-      /sbin/mount.ntfs makes <command>mount</command> default to using Ntfs-3g
-      to mount NTFS partitions.
     </para>