From 6fa16a5033e1563760d92487044e25c1082a94a1 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@mengyan1223.wang>
Date: Wed, 17 Nov 2021 23:31:46 +0800
Subject: [PATCH] udisks2: add a configuration for kernel NTFS3 driver

---
 general/sysutils/udisks2.xml | 39 +++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/general/sysutils/udisks2.xml b/general/sysutils/udisks2.xml
index 4e6b57e02d..ccd07ec07f 100644
--- a/general/sysutils/udisks2.xml
+++ b/general/sysutils/udisks2.xml
@@ -107,7 +107,7 @@
       <xref linkend="dbus-python"/> (for the integration tests),
       <xref linkend="gtk-doc"/>,
       <xref linkend="lvm2"/>,
-      <!-- <xref linkend="ntfs-3g"/>, -->
+      <xref linkend="ntfs-3g"/>,
       <xref linkend="pygobject3"/> (for the integration tests),
       <ulink url="https://github.com/relan/exfat">exFAT</ulink>, and
       <ulink url="https://github.com/sahlberg/libiscsi">libiscsi</ulink>
@@ -168,6 +168,43 @@ make</userinput></screen>
 
   </sect2>
 
+  <sect2 role="configuration">
+    <title>Configuring UDisks2</title>
+
+    <sect3 id="udisks2-config">
+      <title>Config Files</title>
+      <para>
+        <filename>/etc/udisks2/mount_options.conf</filename> and
+        <filename>/etc/udisks2/udisks2.conf</filename>
+      </para>
+
+      <indexterm zone="udisks2 udisks2-config">
+        <primary sortas="e-etc-udisks2-mount_options.conf">/etc/udisks2/mount_options.conf</primary>
+      </indexterm>
+
+      <indexterm zone="udisks2 udisks2-config">
+        <primary sortas="e-etc-udisks2-udisks2.conf">/etc/udisks2/udisks2.conf</primary>
+      </indexterm>
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+      <para>
+        The default configuration of UDisks2 assumes ntfs-3g is used to
+        mount NTFS filesystems.  If the wrapper script for in-kernel NTFS3
+        driver (recommended in the <xref linkend="ntfs-3g"/> page) is used
+        instead, create a configuration file for UDisks2 compatible with
+        NTFS3 to allow mounting NTFS filesystems:
+      </para>
+
+<screen role="root"><userinput>cat &gt;&gt; /etc/udisks2/mount_options.conf &lt;&lt; "EOF"
+<literal>[defaults]
+ntfs_defaults=uid=$UID,gid=$GID</literal>
+EOF</userinput></screen>
+
+    </sect3>
+  </sect2>
+
   <sect2 role="content">
     <title>Contents</title>