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 2ac5db710fa1c94eb0aa67cff33765d1da3fa3e4..36d137eaea931dbda3b623bdc3435481974367c8 100644 (file)
--- 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>