futex.2: Document FUTEX_WAKE_BITSET

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Thomas Gleixner 2015-01-13 15:36:37 +01:00 committed by Michael Kerrisk
parent fd9e59d424
commit 55cc422d78
1 changed files with 12 additions and 3 deletions

View File

@ -444,8 +444,16 @@ argument is ignored.
.TP
.BR FUTEX_WAKE_BITSET " (since Linux 2.6.25)"
.\" commit cd689985cf49f6ff5c8eddc48d98b9d581d9475d
.\" FIXME TO complete
[As yet undocumented]
This operation is the same as
.BR FUTEX_WAKE
except that the
.I val3
argument is used to provide a 32-bit bitset to the kernel.
This bitset is used to select waiters on the futex.
The selection is done by a bitwise AND of the wake side
supplied bitset and the bitset which is stored in the kernel internal
state of the waiters.
If the result is nonzero, the waiter is woken, otherwise left waiting.
.TP
.BR FUTEX_LOCK_PI " (since Linux 2.6.18)"
.\" commit c87e2837be82df479a6bae9f155c43516d2feebc
@ -701,7 +709,8 @@ on
.IR uaddr .
.TP
.B EINVAL
.RB ( FUTEX_WAIT_BITSET )
.RB ( FUTEX_WAIT_BITSET ,
.BR FUTEX_WAKE_BITSET )
The bitset supplied in
.IR val3
is zero.