summaryrefslogtreecommitdiffstats
path: root/man7/futex.7
diff options
context:
space:
mode:
Diffstat (limited to 'man7/futex.7')
-rw-r--r--man7/futex.724
1 files changed, 12 insertions, 12 deletions
diff --git a/man7/futex.7 b/man7/futex.7
index 7a8fcd5a7..d8883a130 100644
--- a/man7/futex.7
+++ b/man7/futex.7
@@ -24,7 +24,7 @@ mutexes, condition variables, read-write locks, barriers, and semaphores.
Most programmers will in fact not be using futexes directly but will
instead rely on system libraries built on them,
such as the Native POSIX Thread Library (NPTL) (see
-.BR pthreads (7)).
+.MR pthreads 7 ).
.P
A futex is identified by a piece of memory which can be
shared between processes or threads.
@@ -42,13 +42,13 @@ In its bare form, a futex is an aligned integer which is
touched only by atomic assembler instructions.
This integer is four bytes long on all platforms.
Processes can share this integer using
-.BR mmap (2),
+.MR mmap 2 ,
via shared memory segments, or because they share memory space,
in which case the application is commonly called multithreaded.
.SS Semantics
Any futex operation starts in user space,
but it may be necessary to communicate with the kernel using the
-.BR futex (2)
+.MR futex 2
system call.
.P
To "up" a futex, execute the proper assembler instructions that
@@ -75,13 +75,13 @@ This is done using the
operation.
.P
The
-.BR futex (2)
+.MR futex 2
system call can optionally be passed a timeout specifying how long
the kernel should
wait for the futex to be upped.
In this case, semantics are more complex and the programmer is referred
to
-.BR futex (2)
+.MR futex 2
for
more details.
The same holds for asynchronous futex waiting.
@@ -97,7 +97,7 @@ the sources of the futex user-space library referenced
below.
.P
This man page illustrates the most common use of the
-.BR futex (2)
+.MR futex 2
primitives; it is by no means the only one.
.\" .SH AUTHORS
.\" .P
@@ -107,12 +107,12 @@ primitives; it is by no means the only one.
.\" Rusty Russell (IBM Linux Technology Center).
.\" This page written by bert hubert.
.SH SEE ALSO
-.BR clone (2),
-.BR futex (2),
-.BR get_robust_list (2),
-.BR set_robust_list (2),
-.BR set_tid_address (2),
-.BR pthreads (7)
+.MR clone 2 ,
+.MR futex 2 ,
+.MR get_robust_list 2 ,
+.MR set_robust_list 2 ,
+.MR set_tid_address 2 ,
+.MR pthreads 7
.P
.I Fuss, Futexes and Furwocks: Fast Userlevel Locking in Linux
(proceedings of the Ottawa Linux Symposium 2002),