summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul E. McKenney <paulmck@kernel.org>2022-11-04 11:00:14 -0700
committerPaul E. McKenney <paulmck@kernel.org>2023-01-03 17:27:37 -0800
commit8750dfe6fda4aca9cc02b3f652d14b14b49bccfb (patch)
treecbf67e9396bd0ff1b45abd92ad625c44f7f34322
parent438500113f375c0b3185cc7ce62baa5f8088a5b2 (diff)
downloadlwn-8750dfe6fda4aca9cc02b3f652d14b14b49bccfb.tar.gz
lwn-8750dfe6fda4aca9cc02b3f652d14b14b49bccfb.zip
doc: Update NMI-RCU.rst
This commit updates NMI-RCU.rst to highlight the ancient heritage of the example code and to discourage wanton compiler "optimizations". Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
-rw-r--r--Documentation/RCU/NMI-RCU.rst4
1 files changed, 2 insertions, 2 deletions
diff --git a/Documentation/RCU/NMI-RCU.rst b/Documentation/RCU/NMI-RCU.rst
index 2a92bc685ef1..dff60a80b386 100644
--- a/Documentation/RCU/NMI-RCU.rst
+++ b/Documentation/RCU/NMI-RCU.rst
@@ -8,7 +8,7 @@ Although RCU is usually used to protect read-mostly data structures,
it is possible to use RCU to provide dynamic non-maskable interrupt
handlers, as well as dynamic irq handlers. This document describes
how to do this, drawing loosely from Zwane Mwaikambo's NMI-timer
-work in "arch/x86/kernel/traps.c".
+work in an old version of "arch/x86/kernel/traps.c".
The relevant pieces of code are listed below, each followed by a
brief explanation::
@@ -116,7 +116,7 @@ Answer to Quick Quiz:
This same sad story can happen on other CPUs when using
a compiler with aggressive pointer-value speculation
- optimizations.
+ optimizations. (But please don't!)
More important, the rcu_dereference_sched() makes it
clear to someone reading the code that the pointer is