From: "Paul E. McKenney" <paulmck@linux.vnet.ibm.com>
To: linux-kernel@vger.kernel.org
Cc: mingo@kernel.org, torvalds@linux-foundation.org,
mark.rutland@arm.com, dhowells@redhat.com,
linux-arch@vger.kernel.org, peterz@infradead.org,
will.deacon@arm.com,
"Paul E. McKenney" <paulmck@linux.vnet.ibm.com>
Subject: [PATCH RFC tip/core/rcu 01/15] doc: READ_ONCE() now implies smp_barrier_depends()
Date: Mon, 9 Oct 2017 17:22:35 -0700 [thread overview]
Message-ID: <1507594969-8347-1-git-send-email-paulmck@linux.vnet.ibm.com> (raw)
In-Reply-To: <20171010001951.GA6476@linux.vnet.ibm.com>
This commit updates an example in memory-barriers.txt to account for
the fact that READ_ONCE() now implies smp_barrier_depends().
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
---
Documentation/memory-barriers.txt | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/Documentation/memory-barriers.txt b/Documentation/memory-barriers.txt
index b759a60624fd..b592bb265e5c 100644
--- a/Documentation/memory-barriers.txt
+++ b/Documentation/memory-barriers.txt
@@ -227,17 +227,18 @@ There are some minimal guarantees that may be expected of a CPU:
(*) On any given CPU, dependent memory accesses will be issued in order, with
respect to itself. This means that for:
- Q = READ_ONCE(P); smp_read_barrier_depends(); D = READ_ONCE(*Q);
+ Q = READ_ONCE(P); D = READ_ONCE(*Q);
the CPU will issue the following memory operations:
Q = LOAD P, D = LOAD *Q
and always in that order. On most systems, smp_read_barrier_depends()
- does nothing, but it is required for DEC Alpha. The READ_ONCE()
- is required to prevent compiler mischief. Please note that you
- should normally use something like rcu_dereference() instead of
- open-coding smp_read_barrier_depends().
+ does nothing, but it is required for DEC Alpha, and is supplied by
+ READ_ONCE(). The READ_ONCE() is also required to prevent compiler
+ mischief. Please note that you should normally use something
+ like READ_ONCE() or rcu_dereference() instead of open-coding
+ smp_read_barrier_depends().
(*) Overlapping loads and stores within a particular CPU will appear to be
ordered within that CPU. This means that for:
--
2.5.2
next prev parent reply other threads:[~2017-10-10 0:22 UTC|newest]
Thread overview: 93+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-10-10 0:19 [PATCH RFC tip/core/rcu 0/15] Remove to-be-unneeded smp_read_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney [this message]
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 01/15] doc: READ_ONCE() now implies smp_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 02/15] mn10300: READ_ONCE() now implies smp_read_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 03/15] drivers/net/ethernet/qlogic/qed: Fix __qed_spq_block() ordering Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 04/15] fs/dcache: Use release-acquire for name/length update Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 05/15] percpu: READ_ONCE() now implies smp_read_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 14:08 ` Tejun Heo
2017-10-10 14:08 ` Tejun Heo
2017-10-10 15:30 ` Paul E. McKenney
2017-10-10 15:30 ` Paul E. McKenney
2017-10-10 15:49 ` Tejun Heo
2017-10-10 15:49 ` Tejun Heo
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 06/15] rcu: Adjust read-side accessor comments for READ_ONCE() Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 07/15] rtnetlink: Update now-misleading smp_read_barrier_depends() comment Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 08/15] seqlock: Remove now-redundant smp_read_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 09/15] uprobes: " Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 10/15] locking: Remove smp_read_barrier_depends() from queued_spin_lock_slowpath() Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 11/15] tracepoint: Remove smp_read_barrier_depends() from comment Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 0:31 ` Steven Rostedt
2017-10-10 1:12 ` Mathieu Desnoyers
2017-10-10 15:32 ` Paul E. McKenney
2017-10-10 15:32 ` Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 12/15] lib/assoc_array: Remove smp_read_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 8:39 ` Peter Zijlstra
2017-10-10 8:39 ` Peter Zijlstra
2017-10-10 9:36 ` David Howells
2017-10-10 9:36 ` David Howells
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 13/15] mm/ksm: Remove now-redundant smp_read_barrier_depends() Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 14/15] netfilter: " Paul E. McKenney
2017-10-10 0:22 ` Paul E. McKenney
2017-10-10 8:43 ` Peter Zijlstra
2017-10-10 8:43 ` Peter Zijlstra
2017-10-10 15:56 ` Paul E. McKenney
2017-10-10 0:22 ` [PATCH RFC tip/core/rcu 15/15] keyring: " Paul E. McKenney
2017-10-10 9:35 ` [PATCH RFC tip/core/rcu 12/15] lib/assoc_array: Remove smp_read_barrier_depends() David Howells
2017-10-10 9:35 ` David Howells
2017-10-10 15:50 ` Paul E. McKenney
2017-10-10 15:54 ` Peter Zijlstra
2017-10-10 15:54 ` Peter Zijlstra
2017-10-10 16:05 ` Paul E. McKenney
2017-10-10 16:05 ` Paul E. McKenney
2017-10-11 12:19 ` David Howells
2017-10-11 12:19 ` David Howells
2017-10-11 12:22 ` Will Deacon
2017-10-11 12:54 ` Paul E. McKenney
2017-10-11 12:54 ` Paul E. McKenney
2017-10-11 14:18 ` Will Deacon
2017-10-11 14:50 ` Paul E. McKenney
2017-10-11 12:58 ` Paul E. McKenney
2017-10-11 12:58 ` Paul E. McKenney
2017-10-11 15:17 ` David Howells
2017-10-11 15:17 ` David Howells
2017-10-11 15:59 ` Paul E. McKenney
2017-10-11 15:59 ` Paul E. McKenney
2017-10-11 16:12 ` Peter Zijlstra
2017-10-11 16:12 ` Peter Zijlstra
2017-10-11 16:24 ` Peter Zijlstra
2017-10-11 16:24 ` Peter Zijlstra
2017-10-11 16:47 ` Paul E. McKenney
2017-10-11 16:54 ` Peter Zijlstra
2017-10-11 17:06 ` Paul E. McKenney
2017-10-11 17:11 ` Peter Zijlstra
2017-10-11 17:34 ` Paul E. McKenney
2017-10-11 18:43 ` Dmitry Vyukov
2017-10-11 18:56 ` Linus Torvalds
2017-10-11 18:56 ` Linus Torvalds
2017-10-11 19:28 ` Paul E. McKenney
2017-10-11 19:59 ` Dmitry Vyukov
2017-10-11 17:14 ` Paul E. McKenney
2017-10-11 17:19 ` Mark Rutland
2017-10-11 17:19 ` Mark Rutland
2017-10-11 16:50 ` Paul E. McKenney
2017-10-11 16:50 ` Paul E. McKenney
2017-10-11 16:07 ` David Howells
2017-10-11 16:07 ` David Howells
2017-10-11 16:17 ` Peter Zijlstra
2017-10-11 16:19 ` Paul E. McKenney
2017-10-11 15:28 ` David Howells
2017-10-11 15:28 ` David Howells
2017-10-11 16:02 ` Paul E. McKenney
2017-10-11 16:02 ` Paul E. McKenney
2017-10-10 9:59 ` David Howells
2017-10-10 15:52 ` Paul E. McKenney
2017-10-11 12:21 ` [PATCH RFC tip/core/rcu 0/15] Remove to-be-unneeded smp_read_barrier_depends() David Howells
2017-10-11 12:56 ` Paul E. McKenney
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1507594969-8347-1-git-send-email-paulmck@linux.vnet.ibm.com \
--to=paulmck@linux.vnet.ibm.com \
--cc=dhowells@redhat.com \
--cc=linux-arch@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mark.rutland@arm.com \
--cc=mingo@kernel.org \
--cc=peterz@infradead.org \
--cc=torvalds@linux-foundation.org \
--cc=will.deacon@arm.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).