fpathconf.3: Largely rewrite the description of _PC_CHOWN_RESTRICTED

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2017-06-18 21:14:56 +02:00
parent 6cde427101
commit 3509905bd8
1 changed files with 15 additions and 6 deletions

View File

@ -137,17 +137,26 @@ The corresponding macro is
.BR _POSIX_PIPE_BUF .
.TP
.B _PC_CHOWN_RESTRICTED
This returns nonzero if the
This returns a positive value if the use of
.BR chown (2)
call may not be used on this file.
and
.BR fchown (2)
for changing a file's user ID is restricted to a process
with appropriate privileges,
and changing a file's group ID to a value other than the process's
effective group ID or one of its supplementary group IDs
is restricted to a process with appropriate privileges.
According to POSIX.1,
this variable shall always be defined with a value other than \-1.
The corresponding macro is
.BR _POSIX_CHOWN_RESTRICTED .
.IP
If
.I fd
or
.I path
refer to a directory, then this applies to all files in that
directory.
The corresponding macro is
.BR _POSIX_CHOWN_RESTRICTED .
refers to a directory,
then the return value applies to all files in that directory.
.TP
.B _PC_NO_TRUNC
This returns nonzero if accessing filenames longer than