From 2b8b0139fcc51a86a29879df220b6b8ca7eda66d Mon Sep 17 00:00:00 2001 From: Andrew Walker Date: Thu, 24 Sep 2020 16:57:59 -0400 Subject: [PATCH] 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 Reviewed-by: Ralph Boehme Reviewed-by: Jeremy Allison Autobuild-User(master): Jeremy Allison Autobuild-Date(master): Thu Oct 15 20:27:34 UTC 2020 on sn-devel-184 --- docs-xml/manpages/vfs_zfsacl.8.xml | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs-xml/manpages/vfs_zfsacl.8.xml b/docs-xml/manpages/vfs_zfsacl.8.xml index 1ac954b9429..9b3ba1b6bc7 100644 --- a/docs-xml/manpages/vfs_zfsacl.8.xml +++ b/docs-xml/manpages/vfs_zfsacl.8.xml @@ -56,6 +56,16 @@ with NFSv4 compatible ACLs. + 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. + + This module is stackable. Since Samba 4.0 all options are per share options. -- 2.34.1