linux/Documentation/mutex-design.txt, branch v3.17-rc3

locking/mutexes: Documentation update/rewrite

2014-06-05T11:29:37Z

Our mutexes have gone a long ways since the original implementation back in 2005/2006. However, the mutex-design.txt document is still stuck in the past, to the point where most of the information there is practically useless and, more important, simply incorrect. This patch pretty much rewrites it to resemble what we have nowadays. Since regular semaphores are almost much extinct in the kernel (most users now rely on mutexes or rwsems), it no longer makes sense to have such a close comparison, which was copied from most of the cover letter when Ingo introduced the generic mutex subsystem. Note that ww_mutexes are intentionally left out, leaving things as generic as possible. Signed-off-by: Davidlohr Bueso Cc: tim.c.chen@linux.intel.com Cc: paulmck@linux.vnet.ibm.com Cc: waiman.long@hp.com Cc: jason.low2@hp.com Cc: aswin@hp.com Cc: Linus Torvalds Cc: Peter Zijlstra Link: http://lkml.kernel.org/r/1401338203.2618.11.camel@buesod1.americas.hpqcorp.net Signed-off-by: Ingo Molnar

locking/doc: Update references to kernel/mutex.c

2013-11-11T11:41:33Z

Fix this docbook error: >> docproc: kernel/mutex.c: No such file or directory by updating the stale references to kernel/mutex.c. Reported-by: fengguang.wu@intel.com Signed-off-by: Peter Zijlstra Link: http://lkml.kernel.org/n/tip-34pikw1tlsskj65rrt5iusrq@git.kernel.org Signed-off-by: Ingo Molnar

mutex: Fix annotations to include it in kernel-locking docbook

2010-09-03T06:19:51Z

Fix kernel-doc notation in linux/mutex.h and kernel/mutex.c, then add these 2 files to the kernel-locking docbook as the Mutex API reference chapter. Add one API function to mutex-design.txt and correct a typo in that file. Signed-off-by: Randy Dunlap Cc: Rusty Russell LKML-Reference: <20100902154816.6cc2f9ad.randy.dunlap@oracle.com> Signed-off-by: Ingo Molnar

Rename .text.lock to .text..lock.

2010-03-03T10:26:00Z

Signed-off-by: Denys Vlasenko Signed-off-by: Michal Marek

Documentation: Add nested versions of mutex locks to docs

2007-10-19T22:15:26Z

Signed-off-by: Robert P. J. Day Signed-off-by: Adrian Bunk

Mutex documentation is unclear about software interrupts, tasklets and timers

2007-10-17T15:42:57Z

Acked-by: Arjan van de Ven Cc: Ingo Molnar Signed-off-by: Andrew Morton Signed-off-by: Linus Torvalds

[PATCH] mutex subsystem, documentation

2006-01-09T23:59:20Z

Add mutex design related documentation. Signed-off-by: Ingo Molnar Signed-off-by: Arjan van de Ven