From a57c98a00089c16f045360fc782a97adc46c9080 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 21 Apr 2015 13:52:16 +0200 Subject: [PATCH] mkdir.2, mknod.2, open.2, umask.2: Tweaks to Andreas's patch Signed-off-by: Michael Kerrisk --- man2/mkdir.2 | 3 ++- man2/mknod.2 | 3 ++- man2/open.2 | 3 ++- man2/umask.2 | 17 +++++++++++------ 4 files changed, 17 insertions(+), 9 deletions(-) diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 42fc26b73..1432f3ade 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -54,7 +54,7 @@ The argument specifies the permissions to use. It is modified by the process's .I umask -in the usual way: in the absence of a default acl, the permissions of the +in the usual way: in the absence of a default ACL, the permissions of the created directory are .RI ( mode " & ~" umask " & 0777)." Other mode bits of the created directory depend on the operating system. @@ -242,4 +242,5 @@ argument. .BR stat (2), .BR umask (2), .BR unlink (2), +.BR acl (5) .BR path_resolution (7) diff --git a/man2/mknod.2 b/man2/mknod.2 index 7a8dd1e1f..e8e49f0b8 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -63,7 +63,7 @@ listed below and the permissions for the new node. The permissions are modified by the process's .I umask -in the usual way: in the absence of a default acl, the permissions of the +in the usual way: in the absence of a default ACL, the permissions of the created node are .RI ( mode " & ~" umask ). @@ -294,4 +294,5 @@ and .BR unlink (2), .BR makedev (3), .BR mkfifo (3), +.BR acl (5) .BR path_resolution (7) diff --git a/man2/open.2 b/man2/open.2 index 1d22b58c2..55bc8ad62 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -275,7 +275,7 @@ is ignored. The effective permissions are modified by the process's .I umask -in the usual way: In the absence of a default acl, the permissions of the +in the usual way: in the absence of a default ACL, the permissions of the created file are .IR "(mode\ &\ ~umask)" . Note that this mode applies only to future accesses of the @@ -1528,6 +1528,7 @@ functionality. .BR unlink (2), .BR write (2), .BR fopen (3), +.BR acl (5) .BR fifo (7), .BR path_resolution (7), .BR symlink (7) diff --git a/man2/umask.2 b/man2/umask.2 index 905f2cdc2..de414bf55 100644 --- a/man2/umask.2 +++ b/man2/umask.2 @@ -63,15 +63,20 @@ argument to and .BR mkdir (2). -Alternatively, if the parent directory has a default acl (see +Alternatively, if the parent directory has a default ACL (see .BR acl (5)), -the umask is ignored, the default acl is inherited, the permission bits are set -based on the inherited acl, and permission bits absent in the +the umask is ignored, the default ACL is inherited, +the permission bits are set based on the inherited ACL, +and permission bits absent in the .I mode -argument are turned off. For example, the default acl -u::rwx,g::r-x,o::r-x is equivalent to a umask of 022, and with a +argument are turned off. +For example, the following default ACL is equivalent to a umask of 022: + + u::rwx,g::r-x,o::r-x + +Combining the effect of this default ACL with a .I mode -argument of 0666 (rw-rw-rw-), the resulting file permissions are 0644 +argument of 0666 (rw-rw-rw-), the resulting file permissions would be 0644 (rw-r--r--). The constants that should be used to specify