documentation: explain memory barriers

We want all uses of memory barriers to be explained in the source code. Signed-off-by: Randy Dunlap <[email protected]> Signed-off-by: Andrew Morton <[email protected]> Signed-off-by: Linus Torvalds <[email protected]>
mna · Oct 16, 2008 · 8033fe6 · 8033fe6
1 parent 7968b3d
commit 8033fe6
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/Documentation/SubmitChecklist b/Documentation/SubmitChecklist
@@ -85,3 +85,6 @@ kernel patches.
 23: Tested after it has been merged into the -mm patchset to make sure
     that it still works with all of the other queued patches and various
     changes in the VM, VFS, and other subsystems.
+
+24: All memory barriers {e.g., barrier(), rmb(), wmb()} need a comment in the
+    source code that explains the logic of what they are doing and why.