[patch] open.2: Document fs.protected_fifos and fs.protected_regular

[patch] open.2: Document fs.protected_fifos and fs.protected_regular

[Joseph C. Sible]

The sysctls fs.protected_fifos and fs.protected_regular can cause
open(2) to fail with EACCES (see Documentation/sysctl/fs.txt for
details.)

Signed-off-by: Joseph C. Sible <josephcsible@gmail.com>
---
 man2/open.2 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/man2/open.2 b/man2/open.2
index b0f485b..9ee42b2 100644
--- a/man2/open.2
+++ b/man2/open.2
@@ -958,6 +958,16 @@ is not allowed.
 (See also
 .BR path_resolution (7).)
 .TP
+.B EACCES
+.\" commit 30aba6656f61ed44cba445a3c0d38b296fa9e8f5
+Where
+.B O_CREAT
+is specified, the fs.protected_fifos or fs.protected_regular sysctl is
+enabled, the file already exists and is a FIFO or regular file, the
+owner of the file is neither the current user nor the owner of the
+containing directory, and the containing directory is both world- or
+group-writable and sticky.
+.TP
 .B EDQUOT
 Where
 .B O_CREAT
--
2.7.4

Re: [patch] open.2: Document fs.protected_fifos and fs.protected_regular

[Michael Kerrisk (man-pages)]

Hello Joseph,

On 9/29/19 5:01 AM, Joseph C. Sible wrote:
> The sysctls fs.protected_fifos and fs.protected_regular can cause
> open(2) to fail with EACCES (see Documentation/sysctl/fs.txt for
> details.)
> 
> Signed-off-by: Joseph C. Sible <josephcsible@gmail.com>
> ---
>  man2/open.2 | 10 ++++++++++
>  1 file changed, 10 insertions(+)
> 
> diff --git a/man2/open.2 b/man2/open.2
> index b0f485b..9ee42b2 100644
> --- a/man2/open.2
> +++ b/man2/open.2
> @@ -958,6 +958,16 @@ is not allowed.
>  (See also
>  .BR path_resolution (7).)
>  .TP
> +.B EACCES
> +.\" commit 30aba6656f61ed44cba445a3c0d38b296fa9e8f5
> +Where
> +.B O_CREAT
> +is specified, the fs.protected_fifos or fs.protected_regular sysctl is
> +enabled, the file already exists and is a FIFO or regular file, the
> +owner of the file is neither the current user nor the owner of the
> +containing directory, and the containing directory is both world- or
> +group-writable and sticky.
> +.TP
>  .B EDQUOT
>  Where
>  .B O_CREAT
> --

Thanks! Patch applied.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/