[Acl-devel] Man page patch for setfacl

[Kenneth Dsouza]

Hello,

Currently, the setfacl utility cannot handle ACL on numeric username and groupname.

Which causes the ACL to be applied to a uid instead of the username intended to.

Example:

useradd 1234

setfacl -m u:1234:rwx /test ------------------------------->> The ACL will be set for a uid 1234 and not username 1234.

Therefore we should update the man page to state out that while setting ACL for numeric username and groupname specify only the uid or gid.


This patch addresses this issue, by ensuring that the end user is aware of such behaviour.

Signed-off-by: Kenneth D'souza <address@hidden>

diff --git a/man/man1/setfacl.1 b/man/man1/setfacl.1
index c4fe1f2..1cd6384 100644
--- a/man/man1/setfacl.1
+++ b/man/man1/setfacl.1
@@ -174,6 +174,19 @@ Effective rights mask
 .fam T
 Permissions of others.
 .PP
+For setting ACL on numeric username and groupname specify only the
+.I uid
+or
+.I gid
+.fam C
+.TP
+.RI "[d[efault]:] [u[ser]:]" "uid " [: perms ]
+.fam T
+.fam C
+.TP
+.RI "[d[efault]:] [g[roup]:]" "gid " [: perms ]
+.fam T
+.PP
 Whitespace between delimiter characters and non-delimiter characters is ignored.
 .PP
 .PP
@@ -274,6 +287,20 @@ setfacl \-m u:lisa:r file
 .fam T
 .RE
 .PP
+Granting an additional numeric user read access
+.RS
+.fam C
+setfacl \-m u:uid:r file
+.fam T
+.RE
+.PP
+Granting an additional numeric group read access
+.RS
+.fam C
+setfacl \-m g:gid:r file
+.fam T
+.RE
+.PP
 Revoking write access from all groups and all named users (using the effective rights mask)
 .RS
 .fam C

Kind Regards,

Kenneth D'souza

Red Hat Pune

address@hidden    M: 8237650988     IRC: KennethD

TRIED. TESTED. TRUSTED.