From a4252ee32cb9068b192e4883c455d7daecf67321 Mon Sep 17 00:00:00 2001 From: Ralph Boehme Date: Tue, 7 Mar 2017 18:10:56 +0100 Subject: [PATCH] manpages/vfs_fruit: document global options Some options MUST be set in the global section, better document that. Bug: https://bugzilla.samba.org/show_bug.cgi?id=12615 Signed-off-by: Ralph Boehme Reviewed-by: Jeremy Allison (cherry picked from commit 0c212c50b59081583572f807cf5214037d1517c4) --- docs-xml/manpages/vfs_fruit.8.xml | 155 ++++++++++++++++++++++++-------------- 1 file changed, 99 insertions(+), 56 deletions(-) diff --git a/docs-xml/manpages/vfs_fruit.8.xml b/docs-xml/manpages/vfs_fruit.8.xml index fa86b6f..9f999da 100644 --- a/docs-xml/manpages/vfs_fruit.8.xml +++ b/docs-xml/manpages/vfs_fruit.8.xml @@ -79,8 +79,81 @@ + GLOBAL OPTIONS + + The following options must be set in the global smb.conf section + and won't take effect when set per share. + + + + + fruit:aapl = yes | no + + A global option whether to enable Apple's SMB2+ + extension codenamed AAPL. Default + yes. This extension enhances + several deficiencies when connecting from Macs: + + + 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. + + The ability to query and modify the + UNIX mode of directory entries. + + + There's a set of per share options that come into play when + fruit:aapl is enabled. These opions, listed + below, can be used to disable the computation of specific Mac + metadata in the directory enumeration context, all are enabled by + default: + + + readdir_attr:aapl_rsize = yes | no + readdir_attr:aapl_finder_info = yes | no + readdir_attr:aapl_max_access = yes | no + + + See below for a description of these options. + + + + + + fruit:nfs_aces = yes | no + + A global option whether support for + querying and modifying the UNIX mode of directory entries via NFS + ACEs is enabled, default yes. + + + + + fruit:copyfile = yes | no + + A global option whether to enable OS X + specific copychunk ioctl that requests a copy of a whole file + along with all attached metadata. + WARNING: the copyfile request is blocking the + client while the server does the copy.. + The default is no. + + + + + + + OPTIONS + The following options can be set either in the global smb.conf section + or per share. + @@ -178,50 +251,6 @@ - fruit:aapl = yes | no - - A global option whether to enable Apple's SMB2+ - extension codenamed AAPL. Default - yes. This extension enhances - several deficiencies when connecting from Macs: - - - 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. - - The ability to query and modify the - UNIX mode of directory entries. - - - 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: - - - readdir_attr:aapl_rsize = true | false - readdir_attr:aapl_finder_info = true | false - readdir_attr:aapl_max_access = true | false - - - - - - - fruit:nfs_aces = yes | no - - Whether support for querying and modifying the - UNIX mode of directory entries via NFS ACEs is enabled, - default yes. - - - - fruit:veto_appledouble = yes | no Note: this option only applies when @@ -243,18 +272,6 @@ - fruit:copyfile = yes | no - - Whether to enable OS X specific copychunk ioctl - that requests a copy of a whole file along with all - attached metadata. - WARNING: the copyfile request is blocking the - client while the server does the copy.. - The default is no. - - - - fruit:posix_rename = yes | no Whether to enable POSIX directory rename behaviour @@ -265,6 +282,32 @@ + + readdir_attr:aapl_rsize = yes | no + + Return resource fork size in SMB2 FIND responses. + The default is yes. + + + + + readdir_attr:aapl_finder_info = yes | no + + Return FinderInfo in SMB2 FIND responses. + The default is yes. + + + + + readdir_attr:aapl_max_access = yes | no + + Return the user's effective maximum permissions in SMB2 FIND + responses. This is an expensive computation, setting this to off + pretends the use has maximum effective permissions. + The default is yes. + + + -- 2.9.3