vfs_zfsacl: add zfs configuration guidance to manpage

Provide minimal background information on recommended ZFS settings
for a samba share.

Signed-off-by: Andrew Walker <awalker@ixsystems.com>
Reviewed-by: Ralph Boehme <slow@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
Autobuild-User(master): Jeremy Allison <jra@samba.org>
Autobuild-Date(master): Thu Oct 15 20:27:34 UTC 2020 on sn-devel-184

diff --git a/docs-xml/manpages/vfs_zfsacl.8.xml b/docs-xml/manpages/vfs_zfsacl.8.xml
index 1ac954b9429b10418a50f5a7ddebbfe40a68fd7c..9b3ba1b6bc7712a35dfd9a88249a77ed71f33023 100644 (file)
--- a/docs-xml/manpages/vfs_zfsacl.8.xml
+++ b/docs-xml/manpages/vfs_zfsacl.8.xml
@@ -56,6 +56,16 @@
        with NFSv4 compatible ACLs.
        </para>
 
+       <para>ZFS has mutiple dataset configuration parameters that determine ACL behavior.
+       Although the nuances of these parameters are outside the scope of this manpage, the
+       "aclmode" and "aclinherit" are of particular importance for samba shares.
+       For datasets that are intended solely as Samba shares, "aclmode = restricted"
+       and "aclinherit = passthrough" provide inheritance behavior most consistent with NTFS ACLs.
+       A "restricted" aclmode prevents chmod() on files that have a non-trivial ACL (one that
+       cannot be expressed as a POSIX mode without loss of information). Consult the relevant ZFS
+       manpages for further information.
+       </para>
+
        <para>This module is stackable.</para>
 
        <para>Since Samba 4.0 all options are per share options.</para>