New: FUTEX_FD was removed already. man description shold be removed too.

http://bugzilla.kernel.org/show_bug.cgi?id=14870

Summary: FUTEX_FD was removed already. man description shold be
removed too.
Product: Documentation
Version: unspecified
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: [email protected]
Regression: No

following commit was removed FUTEX_FD implementation.

commit 82af7aca56c67061420d618cc5a30f0fd4106b80
Author: Eric Sesterhenn <[email protected]>
Date: Fri Jan 25 10:40:46 2008 +0100

Removal of FUTEX_FD

Since FUTEX_FD was scheduled for removal in June 2007 lets remove it.

Google Code search found no users for it and NGPT was abandoned in 2003 according to IBM. futex.h is left untouched to make sure the id does not get reassigned. Since queue_me() has no users left it is commented out to avoid a warning, i didnt remove it completely since it is part of the internal api (matching unqueue_me())

but the man page of futex
(http://www.kernel.org/doc/man-pages/online/pages/man2/futex.2.html) still have following explanation. It should be removed too, I think.

FUTEX_FD (present up to and including Linux 2.6.25)
To support asynchronous wakeups, this operation associates a file descriptor with a futex. If another process executes a
FUTEX_WAKE, the
process will receive the signal number that was passed in val.
The
calling process must close the returned file descriptor after
use. The
arguments timeout, uaddr2 and val3 are ignored.

To prevent race conditions, the caller should test if the futex
has
been upped after FUTEX_FD returns.

Because it was inherently racy, FUTEX_FD has been removed from
Linux

              2.6.26 onwards.

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

http://bugzilla.kernel.org/show_bug.cgi?id=14870

Michael Kerrisk <[email protected]> changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]

--- Comment #1 from Michael Kerrisk <[email protected]> 2010-02-03 06:13:44 --- Hi Motohiro,

The man page clearly states that FUTEX_FD is removed, but the text needs to stay there, so that people using older kernels know about FUTEX_FD. So, I don't plan to make any change to the page.

Cheers,

Michael

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

http://bugzilla.kernel.org/show_bug.cgi?id=14870

KOSAKI Motohiro <[email protected]> changed:

What |Removed |Added
----------------------------------------------------------------------------

             Status|NEW                         |RESOLVED
         Resolution|                            |WILL_NOT_FIX

--- Comment #2 from KOSAKI Motohiro <[email protected]> 2010-02-03 06:16:34 --- ok. I'll close this ticket.

Thanks.

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

http://bugzilla.kernel.org/show_bug.cgi?id=14870

--- Comment #3 from Anonymous Emailer <anonymous-ztI5WcYan/[email protected]> 2010-02-03 06:32:33 ---
Reply-To: mtk.manpages-gM/[email protected]

Thanks!

Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html