documentation: Record rcu_dereference() value mishandling
authorPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Sat, 1 Mar 2014 00:11:28 +0000 (16:11 -0800)
committerPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Tue, 29 Apr 2014 15:38:33 +0000 (08:38 -0700)
commitb4c5bf353452c49edd860a67845627c9a8f32638
tree2831f1d9bf2c3523081312b4d0a5d45eaf19c6a8
parent96224daa16d6589aff87339cf0f630ef13600a59
documentation: Record rcu_dereference() value mishandling

Recent LKML discussings (see http://lwn.net/Articles/586838/ and
http://lwn.net/Articles/588300/ for the LWN writeups) brought out
some ways of misusing the return value from rcu_dereference() that
are not necessarily completely intuitive.  This commit therefore
documents what can and cannot safely be done with these values.

Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Reviewed-by: Josh Triplett <josh@joshtriplett.org>
Documentation/RCU/00-INDEX
Documentation/RCU/checklist.txt
Documentation/RCU/rcu_dereference.txt [new file with mode: 0644]