linux-stable/Documentation/RCU
Paul E. McKenney ef2555cf68 doc: Remove arrayRCU.rst
Although RCU can in theory be used to protect array indexes in a manner
similar to the way it protects pointers, doing so is extremely risky
because of the huge number of optimizations that modern compilers can
apply to integral types.

For but one example, if your code can be configured such that your array
contains only a single element, then indexing that array with any integer
other than zero invokes undefined behavior, which in turn means that
the compiler is within its rights to assume (without checking!) that any
integer used as an index to that array has the value zero.  Therefore,
the compiler can index the array with the constant zero, which breaks
any dependencies that might have otherwise existed between the time the
actual value was loaded and the time that the array was indexed.

This commit therefore removes the arrayRCU.rst file that describes how
to go about carrying dependencies through array indexes.

Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
2022-10-18 14:58:50 -07:00
..
Design context_tracking: Take NMI eqs entrypoints over RCU 2022-07-05 13:32:59 -07:00
checklist.rst There's not a huge amount of activity in the docs tree this time around, 2022-10-03 10:23:32 -07:00
index.rst doc: Remove arrayRCU.rst 2022-10-18 14:58:50 -07:00
listRCU.rst doc/RCU/listRCU: Update example function name 2020-02-27 07:03:13 -08:00
lockdep-splat.rst docs: RCU: Convert lockdep-splat.txt to ReST 2020-06-29 11:58:10 -07:00
lockdep.rst Delete duplicate words from kernel docs 2022-09-27 13:21:43 -06:00
NMI-RCU.rst drivers: Remove CONFIG_OPROFILE support 2021-01-29 10:06:24 +05:30
rcu.rst docs: Update RCU cross-references as suggested in doc-guide 2022-04-20 16:13:52 -07:00
rcu_dereference.rst doc: Update rcu_access_pointer() advice in rcu_dereference.rst 2022-08-31 04:58:15 -07:00
rcubarrier.rst doc: Use CONFIG_PREEMPTION 2021-01-06 16:10:44 -08:00
rculist_nulls.rst docs: Update RCU cross-references as suggested in doc-guide 2022-04-20 16:13:52 -07:00
rcuref.rst docs: RCU: Convert rcuref.txt to ReST 2020-06-29 11:58:11 -07:00
RTFP.txt docs: Correctly spell Stephen Hemminger's name 2021-03-15 13:53:24 -07:00
stallwarn.rst rcu/context-tracking: Remove unused and/or unecessary middle functions 2022-07-05 13:33:00 -07:00
torture.rst docs: RCU: Convert torture.txt to ReST 2020-06-29 11:58:11 -07:00
UP.rst doc: RCU callback locks need only _bh, not necessarily _irq 2019-06-28 09:10:40 -06:00
whatisRCU.rst doc/rcu: Update LWN article URLs and add 2019 article 2022-08-31 04:58:15 -07:00