aboutsummaryrefslogtreecommitdiffstats
path: root/ipc
diff options
context:
space:
mode:
authorDavidlohr Bueso <davidlohr.bueso@hp.com>2013-09-11 17:26:26 -0400
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>2013-10-18 10:45:48 -0400
commita5daa172ff0897c52eb4c6da18b092c757264b2f (patch)
treeaeb3016441cb6024df6a1a283edc762c72d9dcf1 /ipc
parentc143813735d3246637e4ad60bfd4cf042189b83c (diff)
ipc: document general ipc locking scheme
commit 05603c44a7627793219b0bd9a7b236099dc9cd9d upstream. As suggested by Andrew, add a generic initial locking scheme used throughout all sysv ipc mechanisms. Documenting the ids rwsem, how rcu can be enough to do the initial checks and when to actually acquire the kern_ipc_perm.lock spinlock. I found that adding it to util.c was generic enough. Signed-off-by: Davidlohr Bueso <davidlohr.bueso@hp.com> Tested-by: Sedat Dilek <sedat.dilek@gmail.com> Cc: Rik van Riel <riel@redhat.com> Cc: Manfred Spraul <manfred@colorfullife.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org> Cc: Mike Galbraith <efault@gmx.de> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Diffstat (limited to 'ipc')
-rw-r--r--ipc/util.c8
1 files changed, 8 insertions, 0 deletions
diff --git a/ipc/util.c b/ipc/util.c
index 9a1d779a20e2..1ddadcf9a2ab 100644
--- a/ipc/util.c
+++ b/ipc/util.c
@@ -15,6 +15,14 @@
15 * Jun 2006 - namespaces ssupport 15 * Jun 2006 - namespaces ssupport
16 * OpenVZ, SWsoft Inc. 16 * OpenVZ, SWsoft Inc.
17 * Pavel Emelianov <xemul@openvz.org> 17 * Pavel Emelianov <xemul@openvz.org>
18 *
19 * General sysv ipc locking scheme:
20 * when doing ipc id lookups, take the ids->rwsem
21 * rcu_read_lock()
22 * obtain the ipc object (kern_ipc_perm)
23 * perform security, capabilities, auditing and permission checks, etc.
24 * acquire the ipc lock (kern_ipc_perm.lock) throught ipc_lock_object()
25 * perform data updates (ie: SET, RMID, LOCK/UNLOCK commands)
18 */ 26 */
19 27
20#include <linux/mm.h> 28#include <linux/mm.h>