tree 8f074445ca802a48d976b9a9c8595ac7fe603f22
parent d322f45ceed525daa9401154590bbae3222cfefb
author Paul E. McKenney <paulmck@linux.vnet.ibm.com> 1312176782 -0700
committer Paul E. McKenney <paulmck@linux.vnet.ibm.com> 1317271114 -0700

rcu: Improve rcu_assign_pointer() and RCU_INIT_POINTER() documentation

The differences between rcu_assign_pointer() and RCU_INIT_POINTER() are
subtle, and it is easy to use the the cheaper RCU_INIT_POINTER() when
the more-expensive rcu_assign_pointer() should have been used instead.
The consequences of this mistake are quite severe.

This commit therefore carefully lays out the situations in which it it
permissible to use RCU_INIT_POINTER().

Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>