diff options
| author | Andrew Walker <awalker@ixsystems.com> | 2020-09-24 16:57:59 -0400 |
|---|---|---|
| committer | Jeremy Allison <jra@samba.org> | 2020-10-15 20:27:34 +0000 |
| commit | 2b8b0139fcc51a86a29879df220b6b8ca7eda66d (patch) | |
| tree | 00a38703a96cb79b776457ed88848b00a7815873 /docs-xml | |
| parent | c1a37b4f31d5252ce074d41f69e526aa84b0d3b3 (diff) | |
| download | samba-2b8b0139fcc51a86a29879df220b6b8ca7eda66d.tar.gz | |
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
Diffstat (limited to 'docs-xml')
| -rw-r--r-- | docs-xml/manpages/vfs_zfsacl.8.xml | 10 |
1 files changed, 10 insertions, 0 deletions
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. </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> |