summaryrefslogtreecommitdiff
path: root/docs-xml
diff options
context:
space:
mode:
authorAndrew Walker <awalker@ixsystems.com>2020-09-24 11:42:16 -0400
committerKarolin Seeger <kseeger@samba.org>2020-10-30 12:26:29 +0000
commit50bb50341dfc268248cc22b7b1820f6278d82f06 (patch)
tree2d873973e9ffb9e41dc90ba0708775247b9b2dc6 /docs-xml
parent1b03a34523110abbc7478d4633d37994fca760fa (diff)
downloadsamba-50bb50341dfc268248cc22b7b1820f6278d82f06.tar.gz
vfs_zfsacl: Add new parameter to stop automatic addition of special entries
Prevent ZFS from automatically adding NFSv4 special entries (owner@, group@, everyone@). ZFS will automatically add these these entries when calculating the inherited ACL of new files if the ACL of the parent directory lacks an inheriting special entry. This may result in user confusion and unexpected change in permissions of files and directories as the inherited ACL is generated. Blocking this behavior is achieved by setting an inheriting everyone@ that grants no permissions and not adding the entry to the file's Security Descriptor. This change also updates behavior so that the fd-based syscall facl() is used where possible. BUG: https://bugzilla.samba.org/show_bug.cgi?id=14470 RN: vfs_zfsacl: Add new parameter to stop automatic addition of special entries Signed-off-by: Andrew Walker <awalker@ixsystems.com> Reviewed-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org> (cherry picked from commit c10ae30c1185463eb937f69c1fc9914558087167)
Diffstat (limited to 'docs-xml')
-rw-r--r--docs-xml/manpages/vfs_zfsacl.8.xml20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs-xml/manpages/vfs_zfsacl.8.xml b/docs-xml/manpages/vfs_zfsacl.8.xml
index ae583409fe1..1ac954b9429 100644
--- a/docs-xml/manpages/vfs_zfsacl.8.xml
+++ b/docs-xml/manpages/vfs_zfsacl.8.xml
@@ -141,6 +141,26 @@
</varlistentry>
<varlistentry>
+ <term>zfsacl:block_special = [yes|no]</term>
+ <listitem>
+ <para>Prevent ZFS from automatically adding NFSv4 special
+ entries (owner@, group@, everyone@). ZFS will automatically
+ generate these these entries when calculating the inherited ACL
+ of new files if the ACL of the parent directory lacks an
+ inheriting special entry. This may result in user confusion and
+ unexpected change in permissions of files and directories as the
+ inherited ACL is generated. Blocking this behavior is achieved
+ by setting an inheriting everyone@ that grants no permissions
+ and not adding the entry to the file's Security
+ Descriptor</para>
+ <itemizedlist>
+ <listitem><para><command>yes (default)</command></para></listitem>
+ <listitem><para><command>no</command></para></listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>zfsacl:map_dacl_protected = [yes|no]</term>
<listitem>
<para>If enabled and the ZFS ACL on the underlying filesystem does not contain