aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2016-06-24 10:00:25 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2016-06-26 11:25:11 +0200
commit678c99868e1d3668eb290acd55432e3e35d1e122 (patch)
tree8c2ead06ba752ed2d9bc79a9fd9e2879c15640de
parent6c38ce7f1f52ed566d71426a428efeb12f837c0b (diff)
downloadman-pages-678c99868e1d3668eb290acd55432e3e35d1e122.tar.gz
futex.2: Describe FUTEX_BITSET_MATCH_ANY
Describe FUTEX_BITSET_MATCH_ANY and FUTEX_WAIT and FUTEX_WAKE equivalences. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man2/futex.239
1 files changed, 29 insertions, 10 deletions
diff --git a/man2/futex.2 b/man2/futex.2
index 5146a1146c..671b9edb9e 100644
--- a/man2/futex.2
+++ b/man2/futex.2
@@ -761,21 +761,40 @@ including those that are not interested in being woken up
.\" for efficiently implementing Pthreads APIs (which use absolute
.\" timeouts); FUTEX_WAIT provides only relative timeouts.
-The
-.I uaddr2
+The constant
+.BR FUTEX_BITSET_MATCH_ANY ,
+which corresponds to all 32 bits set in the bit mask, can be used as the
+.I val3
+argument for
+.BR FUTEX_WAIT_BITSET
and
+.BR FUTEX_WAKE_BITSET .
+Other than differences in the handling of the
.I timeout
-arguments are ignored.
-
-The
+argument, the
.BR FUTEX_WAIT
-and
-.BR FUTEX_WAKE
-operations correspond to
+operation is equivalent to
.BR FUTEX_WAIT_BITSET
-and
+with
+.IR val3
+specified as
+.BR FUTEX_BITSET_MATCH_ANY ;
+that is, allow a wake-up by any waker.
+The
+.BR FUTEX_WAKE
+operation is equivalent to
.BR FUTEX_WAKE_BITSET
-operations where the bit masks are all ones.
+with
+.IR val3
+specified as
+.BR FUTEX_BITSET_MATCH_ANY ;
+that is, wake up any waiter(s).
+
+The
+.I uaddr2
+and
+.I timeout
+arguments are ignored.
.\"
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.\"