From: Ralph Boehme <slow@samba.org>
Date: Wed, 9 Mar 2016 13:01:05 +0000 (+0100)
Subject: docs: update vfs_fruit manpage
X-Git-Tag: tdb-1.3.9~466
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f28014d81083e61537ea796f0dd9efa24154f5f6;p=thirdparty%2Fsamba.git

docs: update vfs_fruit manpage

Add documentation that ea support = yes is required and explain why all
shares for OS X clients should use fruit if one uses it.

Signed-off-by: Ralph Boehme <slow@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
---

diff --git a/docs-xml/manpages/vfs_fruit.8.xml b/docs-xml/manpages/vfs_fruit.8.xml
index 2ac5db710fa..36d137eaea9 100644
--- a/docs-xml/manpages/vfs_fruit.8.xml
+++ b/docs-xml/manpages/vfs_fruit.8.xml
@@ -45,6 +45,14 @@
 	<command>vfs_streams_xattr</command> which must be loaded
 	together with <command>vfs_fruit</command>.</para>
 
+	<para>vfs_fruit requires "ea support = yes".</para>
+
+	<para>Be careful when mixing shares with and without
+	vfs_fruit. OS X clients negotiate SMB2 AAPL protocol
+	extensions on the first tcon, so mixing shares with and
+	without fruit will globally disable AAPL if the first tcon is
+	without fruit.</para>
+
 	<para>Having shares with ADS support enabled for OS X client
 	is worthwhile because it resembles the behaviour of Apple's
 	own SMB server implementation and it avoids certain severe
@@ -234,6 +242,7 @@
 
 <programlisting>
         <smbconfsection name="[share]"/>
+	<smbconfoption name="ea support">yes</smbconfoption>
 	<smbconfoption name="vfs objects">catia fruit streams_xattr</smbconfoption>
 	<smbconfoption name="fruit:resource">file</smbconfoption>
 	<smbconfoption name="fruit:metadata">netatalk</smbconfoption>