Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8f32543b authored by Paul E. McKenney's avatar Paul E. McKenney Committed by Ingo Molnar
Browse files

EXP litmus_tests: Add comments explaining tests' purposes 



This commit adds comments to the litmus tests summarizing what these
tests are intended to demonstrate.

[ paulmck: Apply Andrea's and Alan's feedback. ]
Suggested-by: default avatarIngo Molnar <mingo@kernel.org>
Signed-off-by: default avatarPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Acked-by: default avatarPeter Zijlstra <peterz@infradead.org>
Cc: Linus Torvalds <torvalds@linux-foundation.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: akiyks@gmail.com
Cc: boqun.feng@gmail.com
Cc: dhowells@redhat.com
Cc: j.alglave@ucl.ac.uk
Cc: linux-arch@vger.kernel.org
Cc: luc.maranget@inria.fr
Cc: nborisov@suse.com
Cc: npiggin@gmail.com
Cc: parri.andrea@gmail.com
Cc: stern@rowland.harvard.edu
Cc: will.deacon@arm.com
Link: http://lkml.kernel.org/r/1519169112-20593-4-git-send-email-paulmck@linux.vnet.ibm.com


Signed-off-by: default avatarIngo Molnar <mingo@kernel.org>
parent ea52d698

tools/memory-model/litmus-tests/CoRR+poonceonce+Once.litmus

+7 −0
Original line number Diff line number Diff line 
C CoRR+poonceonce+Once



(*

 * Result: Never

 *

 * Test of read-read coherence, that is, whether or not two successive

 * reads from the same variable are ordered.

 *)



{}



P0(int *x)

tools/memory-model/litmus-tests/CoRW+poonceonce+Once.litmus

+7 −0
Original line number Diff line number Diff line 
C CoRW+poonceonce+Once



(*

 * Result: Never

 *

 * Test of read-write coherence, that is, whether or not a read from

 * a given variable and a later write to that same variable are ordered.

 *)



{}



P0(int *x)

tools/memory-model/litmus-tests/CoWR+poonceonce+Once.litmus

+7 −0
Original line number Diff line number Diff line 
C CoWR+poonceonce+Once



(*

 * Result: Never

 *

 * Test of write-read coherence, that is, whether or not a write to a

 * given variable and a later read from that same variable are ordered.

 *)



{}



P0(int *x)

tools/memory-model/litmus-tests/CoWW+poonceonce.litmus

+7 −0
Original line number Diff line number Diff line 
C CoWW+poonceonce



(*

 * Result: Never

 *

 * Test of write-write coherence, that is, whether or not two successive

 * writes to the same variable are ordered.

 *)



{}



P0(int *x)

tools/memory-model/litmus-tests/IRIW+mbonceonces+OnceOnce.litmus

+10 −0
Original line number Diff line number Diff line 
C IRIW+mbonceonces+OnceOnce



(*

 * Result: Never

 *

 * Test of independent reads from independent writes with smp_mb()

 * between each pairs of reads.  In other words, is smp_mb() sufficient to

 * cause two different reading processes to agree on the order of a pair

 * of writes, where each write is to a different variable by a different

 * process?

 *)



{}



P0(int *x)