LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / futex.2

diff --git a/original/man2/futex.2 b/original/man2/futex.2
index 5c8d775..2fb667a 100644 (file)
--- a/original/man2/futex.2
+++ b/original/man2/futex.2
@@ -10,14 +10,14 @@
 .\" Modified 2004-06-17 mtk
 .\" Modified 2004-10-07 aeb, added FUTEX_REQUEUE, FUTEX_CMP_REQUEUE
 .\"
-.\" FIXME
+.\" FIXME .
 .\" See also https://bugzilla.kernel.org/show_bug.cgi?id=14303
 .\" 2.6.14 adds FUTEX_WAKE_OP
 .\"    commit 4732efbeb997189d9f9b04708dc26bf8613ed721
 .\"    Author: Jakub Jelinek <jakub@redhat.com>
 .\"    Date:   Tue Sep 6 15:16:25 2005 -0700
 .\"
-.\" FIXME
+.\" FIXME .
 .\" 2.6.18 adds (Ingo Molnar) priority inheritance support:
 .\" FUTEX_LOCK_PI, FUTEX_UNLOCK_PI, and FUTEX_TRYLOCK_PI.  These need
 .\" to be documented in the manual page.  Probably there is sufficient
@@ -30,15 +30,15 @@
 .\"    Author: Ingo Molnar <mingo@elte.hu>
 .\"    Date:   Tue Jun 27 02:54:47 2006 -0700
 .\"
-.\"    See Documentation/futex-requeue-pi.txt
+.\"    See Documentation/pi-futex.txt
 .\"
-.\" FIXME
+.\" FIXME .
 .\" 2.6.25 adds FUTEX_WAKE_BITSET, FUTEX_WAIT_BITSET
 .\"    commit cd689985cf49f6ff5c8eddc48d98b9d581d9475d
 .\"    Author: Thomas Gleixner <tglx@linutronix.de>
 .\"    Date:   Fri Feb 1 17:45:14 2008 +0100
 .\"
-.\" FIXME
+.\" FIXME .
 .\" 2.6.31 adds FUTEX_WAIT_REQUEUE_PI, FUTEX_CMP_REQUEUE_PI
 .\"    commit 52400ba946759af28442dee6265c5c0180ac7122
 .\"    Author: Darren Hart <dvhltc@us.ibm.com>
@@ -50,7 +50,7 @@
 .\"
 .\"    See Documentation/futex-requeue-pi.txt
 .\"
-.TH FUTEX 2 2013-03-15 "Linux" "Linux Programmer's Manual"
+.TH FUTEX 2 2014-05-21 "Linux" "Linux Programmer's Manual"
 .SH NAME
 futex \- fast user-space locking
 .SH SYNOPSIS
@@ -65,6 +65,8 @@ futex \- fast user-space locking
 .BI "          int *" uaddr2 ", int " val3 );
 .\" int *? void *? u32 *?
 .fi
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
 .PP
 The
@@ -116,8 +118,13 @@ and sleeps awaiting
 on this futex address.
 If the
 .I timeout
-argument is non-NULL, its contents describe the minimum
-duration of the wait, which is infinite otherwise.
+argument is non-NULL, its contents specify the duration of the wait.
+(This interval will be rounded up to the system clock granularity,
+and kernel scheduling delays mean that the
+blocking interval may overrun by a small amount.)
+If
+.I timeout
+is NULL, the call blocks indefinitely.
 The arguments
 .I uaddr2
 and
@@ -289,9 +296,9 @@ Initial futex support was merged in Linux 2.5.7 but with different semantics
 from what was described above.
 A 4-argument system call with the semantics
 described in this page was introduced in Linux 2.5.40.
-In Linux 2.5.70 one argument
+In Linux 2.5.70, one argument
 was added.
-In Linux 2.6.7 a sixth argument was added\(emmessy, especially
+In Linux 2.6.7, a sixth argument was added\(emmessy, especially
 on the s390 architecture.
 .SH CONFORMING TO
 This system call is Linux-specific.
@@ -310,6 +317,7 @@ read the sources of the futex user-space library referenced below.
 .\" and Rusty Russell (IBM Linux Technology Center).
 .\" This page written by bert hubert.
 .SH SEE ALSO
+.BR restart_syscall (2),
 .BR futex (7)
 .PP
 \fIFuss, Futexes and Furwocks: Fast Userlevel Locking in Linux\fP
@@ -320,5 +328,14 @@ read the sources of the futex user-space library referenced below.
 .PP
 Futex example library, futex-*.tar.bz2 at
 .br
-.UR ftp://ftp.nl.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/
+.UR ftp://ftp.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/
 .UE
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.