tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
fork atom

documentation: explain memory barriers

We want all uses of memory barriers to be explained in the source code.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

authored by

Randy Dunlap and committed by
Linus Torvalds 8033fe65 7968b3d9

+3
+3
Documentation/SubmitChecklist
··· 85 85 23: Tested after it has been merged into the -mm patchset to make sure 86 86 that it still works with all of the other queued patches and various 87 87 changes in the VM, VFS, and other subsystems. 88 + 89 + 24: All memory barriers {e.g., barrier(), rmb(), wmb()} need a comment in the 90 + source code that explains the logic of what they are doing and why.