Merge tag 'devicetree-for-4.3' of git://git.kernel.org/pub/scm/linux/kernel/git/robh...

[firefly-linux-kernel-4.4.55.git] / Documentation / RCU / checklist.txt

diff --git a/Documentation/RCU/checklist.txt b/Documentation/RCU/checklist.txt
index 9d10d1db16a53ffc464c484cc7fe1b7ef2a1e864..877947130ebe63fb822b181fa0bb2cbd011d4218 100644 (file)
--- a/Documentation/RCU/checklist.txt
+++ b/Documentation/RCU/checklist.txt
@@ -114,12 +114,16 @@ over a rather long period of time, but improvements are always welcome!
                        http://www.openvms.compaq.com/wizard/wiz_2637.html
 
                The rcu_dereference() primitive is also an excellent
-               documentation aid, letting the person reading the code
-               know exactly which pointers are protected by RCU.
+               documentation aid, letting the person reading the
+               code know exactly which pointers are protected by RCU.
                Please note that compilers can also reorder code, and
                they are becoming increasingly aggressive about doing
-               just that.  The rcu_dereference() primitive therefore
-               also prevents destructive compiler optimizations.
+               just that.  The rcu_dereference() primitive therefore also
+               prevents destructive compiler optimizations.  However,
+               with a bit of devious creativity, it is possible to
+               mishandle the return value from rcu_dereference().
+               Please see rcu_dereference.txt in this directory for
+               more information.
 
                The rcu_dereference() primitive is used by the
                various "_rcu()" list-traversal primitives, such