vfs_fruit: add AAPL options
authorRalph Boehme <slow@samba.org>
Fri, 28 Nov 2014 21:44:29 +0000 (22:44 +0100)
committerJeremy Allison <jra@samba.org>
Thu, 4 Dec 2014 23:34:00 +0000 (00:34 +0100)
Signed-off-by: Ralph Boehme <slow@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
Autobuild-User(master): Jeremy Allison <jra@samba.org>
Autobuild-Date(master): Fri Dec  5 00:34:01 CET 2014 on sn-devel-104

docs-xml/manpages/vfs_fruit.8.xml

index 47caeb008e72c7f825be97d4e9de3b24d1415bbf..a9e2e6d2a540b255b38e0fc3e58e149c072f1477 100644 (file)
            </listitem>
          </varlistentry>
 
+         <varlistentry>
+           <term>fruit:aapl = yes | no</term>
+           <listitem>
+             <para>A global option whether to enable Apple's SMB2+
+             extension codenamed AAPL. Default
+             <emphasis>yes</emphasis>. This extension enhances
+             several deficiencies when connecting from Macs:</para>
+
+             <itemizedlist>
+               <listitem><para>directory enumeration is enriched with
+               Mac relevant filesystem metadata (UNIX mode,
+               FinderInfo, resource fork size and effective
+               permission), as a result the Mac client doesn't need
+               to fetch this metadata individuallly per directory
+               entry resulting in an often tremendous performance
+               increase.</para></listitem>
+
+               <listitem><para>The ability to query and modify the
+               UNIX mode of directory entries.</para></listitem>
+             </itemizedlist>
+
+             <para>There's a set of per share options that can be
+             used to disable the computation of specific Mac metadata
+             in the directory enumeration context, all are enabled by
+             default:</para>
+
+             <itemizedlist>
+               <listitem><para>readdir_attr:aapl_rsize = true | false</para></listitem>
+               <listitem><para>readdir_attr:aapl_finder_info = true | false</para></listitem>
+               <listitem><para>readdir_attr:aapl_max_access = true | false</para></listitem>
+             </itemizedlist>
+
+           </listitem>
+         </varlistentry>
+
        </variablelist>
 </refsect1>