[PATCH]Futex doc.

[PATCH]Futex doc.

[ffrederick]

Hi,
     Someone could help me having a complete futex doc ?
Here's a first version :

Regards,
Fabian

Documentation for futexes               kernel version 2.6.0-test6
        (c) 2003 Fabian Frederick <ffrederick@users.sourceforge.net>

Note : Based on user man page by Bert Hubert - Comments by Jamie Lokier.

===============================================================================

This file contains documentation for Fast Userspace Mutexes.
For complete authors list and sources you can read /kernel/futex.c

===============================================================================

What's a mutex ?

Mutex stands for mutual exclusion.In other words, it helps synchronizing processes
against shared memory access for instance.

Futex is basically a counter whose value is atomically updated in userland.
Any concurrent access will be managed in kernel space.

3 futex types exist :

	-shared
	-private
	-both

===============================================================================

Linux implementation

You can find POSIX mutex adaptation through futexes.User point of view and 
documentation can be found at http://ds9a.nl/futex-manpages/

Futex interface is sys_futex syscall.Here are recognized operations:

	-FUTEX_WAIT    : Wait a process to up futex.
	-FUTEX_WAKE    : Wake up all futex waiters.
	-FUTEX_FD      : Associate a file descriptor to futex
	-FUTEX_REQUEUE : Requeue all waiters hashed on one physical page to another
                         physical page.



___________________________________

Re: [PATCH]Futex doc.

[Ulrich Drepper]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

ffrederick@prov-liege.be wrote:
>      Someone could help me having a complete futex doc ?

I wrote something recently.

  http://people.redhat.com/drepper/futex.pdf

- -- 
- --------------.                        ,-.            444 Castro Street
Ulrich Drepper \    ,-----------------'   \ Mountain View, CA 94041 USA
Red Hat         `--' drepper at redhat.com `---------------------------
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE/kHYo2ijCOnn/RHQRAivVAJwJvnEVaidXP6dheZBz7zURjMxAcACgzZeW
bMMBk0PaaTI5i1IYzCPs1sM=
=ZOc2
-----END PGP SIGNATURE-----