Commit 773810d3 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Jonathan Corbet

robust-futexes.txt: standardize document format

Each text file under Documentation follows a different
format. Some doesn't even have titles!

Change its representation to follow the adopted standard,
using ReST markups for it to be parseable by Sphinx:

- add a title for the document;
- mark literal blocks;
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent ce3a9669
Started by: Ingo Molnar <mingo@redhat.com> ========================================
A description of what robust futexes are
========================================
:Started by: Ingo Molnar <mingo@redhat.com>
Background Background
---------- ----------
...@@ -163,7 +167,7 @@ Implementation details ...@@ -163,7 +167,7 @@ Implementation details
---------------------- ----------------------
The patch adds two new syscalls: one to register the userspace list, and The patch adds two new syscalls: one to register the userspace list, and
one to query the registered list pointer: one to query the registered list pointer::
asmlinkage long asmlinkage long
sys_set_robust_list(struct robust_list_head __user *head, sys_set_robust_list(struct robust_list_head __user *head,
...@@ -185,7 +189,7 @@ straightforward. The kernel doesn't have any internal distinction between ...@@ -185,7 +189,7 @@ straightforward. The kernel doesn't have any internal distinction between
robust and normal futexes. robust and normal futexes.
If a futex is found to be held at exit time, the kernel sets the If a futex is found to be held at exit time, the kernel sets the
following bit of the futex word: following bit of the futex word::
#define FUTEX_OWNER_DIED 0x40000000 #define FUTEX_OWNER_DIED 0x40000000
...@@ -193,7 +197,7 @@ and wakes up the next futex waiter (if any). User-space does the rest of ...@@ -193,7 +197,7 @@ and wakes up the next futex waiter (if any). User-space does the rest of
the cleanup. the cleanup.
Otherwise, robust futexes are acquired by glibc by putting the TID into Otherwise, robust futexes are acquired by glibc by putting the TID into
the futex field atomically. Waiters set the FUTEX_WAITERS bit: the futex field atomically. Waiters set the FUTEX_WAITERS bit::
#define FUTEX_WAITERS 0x80000000 #define FUTEX_WAITERS 0x80000000
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment