]> git.karo-electronics.de Git - karo-tx-linux.git/commitdiff
documentation: Add acquire/release barriers to pairing rules
authorPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Thu, 19 Jun 2014 17:01:23 +0000 (10:01 -0700)
committerPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Thu, 26 Jun 2014 17:59:41 +0000 (10:59 -0700)
It is possible to pair acquire and release barriers with other barriers,
so this commit adds them to the list in the SMP barrier pairing section.

Reported-by: Lai Jiangshan <laijs@cn.fujitsu.com>
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Reviewed-by: Tejun Heo <tj@kernel.org>
Documentation/memory-barriers.txt

index a6ca533a73fc4dd76c6031e5493e4d209b77b123..2a7c3c4fb53fb2a32eadc7c3faaca39f16188589 100644 (file)
@@ -757,10 +757,12 @@ SMP BARRIER PAIRING
 When dealing with CPU-CPU interactions, certain types of memory barrier should
 always be paired.  A lack of appropriate pairing is almost certainly an error.
 
-A write barrier should always be paired with a data dependency barrier or read
-barrier, though a general barrier would also be viable.  Similarly a read
-barrier or a data dependency barrier should always be paired with at least an
-write barrier, though, again, a general barrier is viable:
+A write barrier should always be paired with a data dependency barrier,
+acquire barrier, release barrier, or read barrier, though a general
+barrier would also be viable.  Similarly a read barrier or a data
+dependency barrier should always be paired with at least a write barrier,
+an acquire barrier, or a release barrier, though, again, a general
+barrier is viable:
 
        CPU 1                 CPU 2
        ===============       ===============