Ready for 5.00

[thirdparty/man-pages.git] / man2 / semctl.2

diff --git a/man2/semctl.2 b/man2/semctl.2
index 02930d2c74aea535a7c6ced9daf7bccb2b903f0c..5d0406c6bc846e2753c80173b8ec26ba37a8717f 100644 (file)
--- a/man2/semctl.2
+++ b/man2/semctl.2
@@ -37,8 +37,9 @@
 .\"    Rewrote semun text
 .\"    Added semid_ds and ipc_perm structure definitions
 .\" 2005-08-02, mtk: Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
+.\" 2018-03-20, dbueso: Added SEM_STAT_ANY description.
 .\"
-.TH SEMCTL 2 2017-09-15 "Linux" "Linux Programmer's Manual"
+.TH SEMCTL 2 2019-03-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 semctl \- System V semaphore control operations
 .SH SYNOPSIS
@@ -240,6 +241,19 @@ argument is not a semaphore identifier, but instead an index into
 the kernel's internal array that maintains information about
 all semaphore sets on the system.
 .TP
+.BR SEM_STAT_ANY " (Linux-specific, since Linux 4.17)"
+Return a
+.I seminfo
+structure containing the same information as for
+.BR SEM_STAT .
+However,
+.I sem_perm.mode
+is not checked for read access for
+.IR semid
+meaning that any user can employ this operation (just as any user may read
+.IR /proc/sysvipc/sem
+to obtain the same information).
+.TP
 .B GETALL
 Return
 .B semval
@@ -368,6 +382,8 @@ kernel's internal array recording information about all
 semaphore sets.
 (This information can be used with repeated
 .B SEM_STAT
+or
+.B SEM_STAT_ANY
 operations to obtain information about all semaphore sets on the system.)
 .TP
 .B SEM_INFO
@@ -377,6 +393,10 @@ as for
 .B SEM_STAT
 the identifier of the semaphore set whose index was given in
 .IR semid .
+.TP
+.B SEM_STAT_ANY
+as for
+.BR SEM_STAT .
 .PP
 All other
 .I cmd
@@ -397,6 +417,7 @@ has one of the values
 .BR GETZCNT ,
 .BR IPC_STAT ,
 .BR SEM_STAT ,
+.BR SEM_STAT_ANY ,
 .BR SETALL ,
 or
 .B SETVAL