summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/server/plugins/generators/rules.txt16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/server/plugins/generators/rules.txt b/doc/server/plugins/generators/rules.txt
index 0b143dcd6..107ec148a 100644
--- a/doc/server/plugins/generators/rules.txt
+++ b/doc/server/plugins/generators/rules.txt
@@ -376,6 +376,22 @@ It is not currently possible to manually set an effective rights mask;
the mask will be automatically calculated from the given ACLs when
they are applied.
+Note that it is possible to set ACLs that demand different permissions
+on a file than those specified in the ``perms`` attribute on the
+``Path`` tag. For instance:
+
+.. code-block:: xml
+
+ <Path name="/etc/foo" perms="0644" group="root" owner="root">
+ <ACL type="access" scope="user" user="foouser" perms="rwx"/>
+ </Path>
+
+In this case, we've specified permissions of ``0644``, but the
+effective rights mask will be "rwx," so setting the ACL will change
+the permissions to ``0674``. When this happens, Bcfg2 will change the
+permissions and set the ACLs on every run and the entry will be
+eternally marked as bad.
+
SELinux Tag
-----------