Skip to contentSkip to conversation

RCU documentation 1Q09 update

PATCH In review Paul E. McKenney 1 participant 2 messages Mar 8, 2009

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 RCU documentation 1Q09 update

Update the RCU documentation to call out the need for callers of primitives like call_rcu() and synchronize_rcu() to prevent subsequent RCU readers from hazard.

---

 checklist.txt |   12 ++++++++++++
 1 file changed, 12 insertions(+)
Documentation/RCU/checklist.txt +12 -0
index 6e25340..accfe2f 100644
@@ -298,3 +298,15 @@ over a rather long period of time, but improvements are always welcome!
 
 	Note that, rcu_assign_pointer() and rcu_dereference() relate to
 	SRCU just as they do to other forms of RCU.
+
+15.	The whole point of call_rcu(), synchronize_rcu(), and friends
+	is to wait until all pre-existing readers have finished before
+	carrying out some otherwise-destructive operation.  It is
+	therefore critically important to -first- remove any path
+	that readers can follow that could be affected by the
+	destructive operation, and -only- -then- invoke call_rcu(),
+	synchronize_rcu(), or friends.
+
+	Because these primitives only wait for pre-existing readers,
+	it is the caller's responsibility to guarantee safety to
+	any subsequent readers.
#1 lore raw

[tip:core/rcu] rcu: documentation 1Q09 update

Commit-ID:  26fe8c643f7ca90e3d9ee2bf3c5d3d83cca650ec
Gitweb:     http://git.kernel.org/tip/26fe8c643f7ca90e3d9ee2bf3c5d3d83cca650ec
Author:     "Paul E. McKenney" <[email protected]>
AuthorDate: Sat, 7 Mar 2009 16:11:38 -0800
Commit:     Ingo Molnar <[email protected]>
CommitDate: Sun, 8 Mar 2009 16:53:04 +0100

rcu: documentation 1Q09 update

Update the RCU documentation to call out the need for callers of primitives like call_rcu() and synchronize_rcu() to prevent subsequent RCU readers from hazard.

LKML-Reference: <[email protected]>

---
 Documentation/RCU/checklist.txt |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)
Documentation/RCU/checklist.txt +12 -0
index 6e25340..accfe2f 100644
@@ -298,3 +298,15 @@ over a rather long period of time, but improvements are always welcome!
 
 	Note that, rcu_assign_pointer() and rcu_dereference() relate to
 	SRCU just as they do to other forms of RCU.
+
+15.	The whole point of call_rcu(), synchronize_rcu(), and friends
+	is to wait until all pre-existing readers have finished before
+	carrying out some otherwise-destructive operation.  It is
+	therefore critically important to -first- remove any path
+	that readers can follow that could be affected by the
+	destructive operation, and -only- -then- invoke call_rcu(),
+	synchronize_rcu(), or friends.
+
+	Because these primitives only wait for pre-existing readers,
+	it is the caller's responsibility to guarantee safety to
+	any subsequent readers.