vfs_fruit: document added zero_file_id parameter

BUG: https://bugzilla.samba.org/show_bug.cgi?id=12715

Signed-off-by: Uri Simchoni <uri@samba.org>
Reviewed-by: Ralph Boehme <slow@samba.org>

diff --git a/docs-xml/manpages/vfs_fruit.8.xml b/docs-xml/manpages/vfs_fruit.8.xml
index a00f6a9b9e04a2d581e85bb37872ce3a6ba1b457..0bddd4aea1a73d8e2133c84b050cc46bb066ddbf 100644 (file)
--- a/docs-xml/manpages/vfs_fruit.8.xml
+++ b/docs-xml/manpages/vfs_fruit.8.xml
@@ -143,6 +143,23 @@
            </listitem>
          </varlistentry>
 
+         <varlistentry>
+           <term>fruit:zero_file_id = yes | no</term>
+           <listitem>
+             <para>A <emphasis>global</emphasis> option whether to return
+             zero to queries of on-disk file identifier, if the client
+             has negotiated AAPL.</para>
+             <para>Mac applications and / or the Mac SMB
+             client code expect the on-disk file identifier to have the
+             semantics of HFS+ Catalog Node Identifier (CNID). Samba
+             doesn't provide those semantics, and that occasionally cause
+             usability issues or even data loss. Returning a file identifier
+             of zero causes the Mac client to stop using and trusting the
+             file id returned from the server.</para>
+             <para>The default is <emphasis>yes</emphasis>.</para>
+           </listitem>
+         </varlistentry>
+
        </variablelist>
 </refsect1>