From d3346766d78a32194a06ee9d7f0d80cf7cd13c8e Mon Sep 17 00:00:00 2001 From: Tim Shimmin Date: Thu, 20 Sep 2007 16:20:03 +0000 Subject: Update acl.5 man page to clarify the relationship between the file permissions and the *OBJ ACL entries. Merge of master-melb:xfs-cmds:29736a by kenmcd. Mention acl.5 man page change. --- man/man5/acl.5 | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) (limited to 'man') diff --git a/man/man5/acl.5 b/man/man5/acl.5 index 12c47fa..22ed5a3 100644 --- a/man/man5/acl.5 +++ b/man/man5/acl.5 @@ -94,19 +94,22 @@ default ACL. This is equivalent to using the function. .Sh CORRESPONDENCE BETWEEN ACL ENTRIES AND FILE PERMISSION BITS The permissions defined by ACLs are a superset of the permissions -specified by the file permission bits. The permissions defined for -the file owner correspond to the permissions of the ACL_USER_OBJ entry. -The permissions defined for the file group correspond to the permissions -of the ACL_GROUP_OBJ entry, if the ACL has no ACL_MASK entry. If the ACL -has an ACL_MASK entry, then the permissions defined for the file group -correspond to the permissions of the ACL_MASK entry. The permissions -defined for the other class correspond to the permissions of the -ACL_OTHER_OBJ entry. +specified by the file permission bits. .Pp -Modification of the file permission bits results in the modification of -the permissions in the associated ACL entries. Modification of the -permissions in the ACL entries results in the modification of the file -permission bits. +There is a correspondence between the file owner, group, and other +permissions and specific ACL entries: the owner permissions correspond +to the permissions of the ACL_USER_OBJ entry. If the ACL has an ACL_MASK +entry, the group permissions correspond to the permissions of the +ACL_MASK entry. Otherwise, if the ACL has no ACL_MASK entry, the group +permissions correspond to the permissions of the ACL_GROUP_OBJ entry. +The other permissions correspond to the permissions of the ACL_OTHER_OBJ +entry. +.Pp +The file owner, group, and other permissions always match the +permissions of the corresponding ACL entry. Modification of the file +permission bits results in the modification of the associated ACL +entries, and modification of these ACL entries results in the +modification of the file permission bits. .Sh OBJECT CREATION AND DEFAULT ACLs The access ACL of a file object is initialized when the object is created with any of the -- cgit v1.2.1