]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man2const/FUTEX_CMP_REQUEUE_PI.2const: Tweak after split
authorAlejandro Colomar <alx@kernel.org>
Thu, 29 May 2025 22:34:39 +0000 (00:34 +0200)
committerAlejandro Colomar <alx@kernel.org>
Fri, 30 May 2025 12:44:25 +0000 (14:44 +0200)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man2const/FUTEX_CMP_REQUEUE_PI.2const

index 934f7f3c1a296e221b27991f87d48da199713933..a0d9e0b8b61590e07ea1e3f4807cfe4efd6bebc7 100644 (file)
@@ -23,36 +23,29 @@ Standard C library
 .BI "             uint32_t " val3 );
 .fi
 .SH DESCRIPTION
-.TP
-.BR FUTEX_CMP_REQUEUE_PI " (since Linux 2.6.31)"
-.\" commit 52400ba946759af28442dee6265c5c0180ac7122
 This operation is a PI-aware variant of
 .BR FUTEX_CMP_REQUEUE (2const).
 It requeues waiters that are blocked via
-.B FUTEX_WAIT_REQUEUE_PI
+.BR FUTEX_WAIT_REQUEUE_PI (2const)
 on
 .I uaddr
 from a non-PI source futex
 .RI ( uaddr )
 to a PI target futex
 .RI ( uaddr2 ).
-.IP
-As with
+.P
+Unlike with
 .BR FUTEX_CMP_REQUEUE (2const),
 this operation wakes up a maximum of
-.I val
-waiters that are waiting on the futex at
-.IR uaddr .
-However, for
-.BR FUTEX_CMP_REQUEUE_PI ,
-.I val
-is required to be 1
+1
+waiter that is waiting on the futex at
+.I uaddr
 (since the main point is to avoid a thundering herd).
 The remaining waiters are removed from the wait queue of the source futex at
 .I uaddr
 and added to the wait queue of the target futex at
 .IR uaddr2 .
-.IP
+.P
 The
 .I val2
 .\" val2 is the cap on the number of requeued waiters.
@@ -82,8 +75,7 @@ On success,
 Returns the total number of waiters that were woken up or
 requeued to the futex for the futex word at
 .IR uaddr2 .
-If this value is greater than
-.IR val ,
+If this value is greater than 1,
 then difference is the number of waiters requeued to the futex for
 the futex word at
 .IR uaddr2 .
@@ -185,7 +177,7 @@ call for that waiter.
 .TP
 .B EINVAL
 The
-.I val
+fourth
 argument is not 1.
 .TP
 .B ENOMEM
@@ -213,5 +205,7 @@ does not exist.
 .SH STANDARDS
 Linux.
 .SH HISTORY
+Linux 2.6.31.
+.\" commit 52400ba946759af28442dee6265c5c0180ac7122
 .SH SEE ALSO
 .BR futex (2)