Merge tag 'mm-hotfixes-stable-2025-07-11-16-16' of git://git.kernel.org/pub/scm/linux...
[linux-2.6-block.git] / tools / memory-model / Documentation / cheatsheet.txt
CommitLineData
1c27b644
PM
1 Prior Operation Subsequent Operation
2 --------------- ---------------------------
a8391951 3 C Self R W RMW Self R W DR DW RMW SV
bd5c0ba2 4 -- ---- - - --- ---- - - -- -- --- --
1c27b644 5
0ce0c78e
PM
6Relaxed store Y Y
7Relaxed load Y Y Y Y
8Relaxed RMW operation Y Y Y Y
bf28ae56 9rcu_dereference() Y Y Y Y
1c27b644
PM
10Successful *_acquire() R Y Y Y Y Y Y
11Successful *_release() C Y Y Y W Y
12smp_rmb() Y R Y Y R
13smp_wmb() Y W Y Y W
14smp_mb() & synchronize_rcu() CP Y Y Y Y Y Y Y Y
15Successful full non-void RMW CP Y Y Y Y Y Y Y Y Y Y Y
16smp_mb__before_atomic() CP Y Y Y a a a a Y
bfd403bb 17smp_mb__after_atomic() CP a a Y Y Y Y Y Y
1c27b644
PM
18
19
0ce0c78e
PM
20Key: Relaxed: A relaxed operation is either READ_ONCE(), WRITE_ONCE(),
21 a *_relaxed() RMW operation, an unsuccessful RMW
22 operation, a non-value-returning RMW operation such
23 as atomic_inc(), or one of the atomic*_read() and
24 atomic*_set() family of operations.
25 C: Ordering is cumulative
26 P: Ordering propagates
27 R: Read, for example, READ_ONCE(), or read portion of RMW
28 W: Write, for example, WRITE_ONCE(), or write portion of RMW
29 Y: Provides ordering
30 a: Provides ordering given intervening RMW atomic operation
31 DR: Dependent read (address dependency)
32 DW: Dependent write (address, data, or control dependency)
33 RMW: Atomic read-modify-write operation
34 SELF: Orders self, as opposed to accesses before and/or after
35 SV: Orders later accesses to the same variable