|
 |
0f16a9 |
From ecee95a94420d6b0336d4caec6bc66b53442367b Mon Sep 17 00:00:00 2001
|
|
|
0f16a9 |
From: Kamil Dudka <kdudka@redhat.com>
|
|
|
0f16a9 |
Date: Thu, 19 May 2016 10:28:13 +0200
|
|
|
0f16a9 |
Subject: [PATCH] setfacl.1: document the meaning of '-' in perms
|
|
|
0f16a9 |
|
|
|
0f16a9 |
[agruen: Description further clarified.]
|
|
|
0f16a9 |
|
|
|
0f16a9 |
Upstream-commit: ea3c6bb711e76d91759f8bf5475e1900362a3142
|
|
|
0f16a9 |
Signed-off-by: Kamil Dudka <kdudka@redhat.com>
|
|
|
0f16a9 |
---
|
|
|
0f16a9 |
man/man1/setfacl.1 | 28 +++++++++++++++++++++-------
|
|
|
0f16a9 |
1 file changed, 21 insertions(+), 7 deletions(-)
|
|
|
0f16a9 |
|
|
|
0f16a9 |
diff --git a/man/man1/setfacl.1 b/man/man1/setfacl.1
|
|
|
0f16a9 |
index 0c7c046..e092e51 100644
|
|
|
0f16a9 |
--- a/man/man1/setfacl.1
|
|
|
0f16a9 |
+++ b/man/man1/setfacl.1
|
|
|
0f16a9 |
@@ -194,18 +194,32 @@ you can specify either a name or a number.
|
|
|
0f16a9 |
.PP
|
|
|
0f16a9 |
The
|
|
|
0f16a9 |
.I perms
|
|
|
0f16a9 |
-field is a combination of characters that indicate the permissions: read
|
|
|
0f16a9 |
+field is a combination of characters that indicate the read
|
|
|
0f16a9 |
.IR (r) ,
|
|
|
0f16a9 |
write
|
|
|
0f16a9 |
.IR (w) ,
|
|
|
0f16a9 |
execute
|
|
|
0f16a9 |
-.IR (x) ,
|
|
|
0f16a9 |
-execute only if the file is a directory or already has execute permission
|
|
|
0f16a9 |
-for some user
|
|
|
0f16a9 |
-.IR (X) .
|
|
|
0f16a9 |
-Alternatively, the
|
|
|
0f16a9 |
+.IR (x)
|
|
|
0f16a9 |
+permissions. Dash characters in the
|
|
|
0f16a9 |
.I perms
|
|
|
0f16a9 |
-field can be an octal digit (0\-7).
|
|
|
0f16a9 |
+field
|
|
|
0f16a9 |
+.IR (\-)
|
|
|
0f16a9 |
+are ignored. The character
|
|
|
0f16a9 |
+.I X
|
|
|
0f16a9 |
+stands for the execute permission if the file is a directory or already has
|
|
|
0f16a9 |
+execute permission for some user. Alternatively, the
|
|
|
0f16a9 |
+.I perms
|
|
|
0f16a9 |
+field can define the permissions numerically, as a bit-wise combination of read
|
|
|
0f16a9 |
+.IR (4) ,
|
|
|
0f16a9 |
+write
|
|
|
0f16a9 |
+.IR (2) ,
|
|
|
0f16a9 |
+and execute
|
|
|
0f16a9 |
+.IR (1) .
|
|
|
0f16a9 |
+Zero
|
|
|
0f16a9 |
+.I perms
|
|
|
0f16a9 |
+fields or
|
|
|
0f16a9 |
+.I perms
|
|
|
0f16a9 |
+fields that only consist of dashes indicate no permissions.
|
|
|
0f16a9 |
.PP
|
|
|
0f16a9 |
.SS AUTOMATICALLY CREATED ENTRIES
|
|
|
0f16a9 |
Initially, files and directories contain only the three base ACL entries
|
|
|
0f16a9 |
--
|
|
|
0f16a9 |
2.5.5
|
|
|
0f16a9 |
|