[PATCH tip/core/rcu 0/14] Documentation updates for 4.6
From: Paul E. McKenney
Date: Wed Feb 24 2016 - 00:08:47 EST
Hello!
This series contains documentation updates as follows:
1. Update the requirements design-level documentation to record RCU's
responsibility to avoid injecting OS jitter onto nohz_full CPUs.
2. Fix control-dependency summary of memory-barriers.txt to
note that barrier() does not always prevent code reordering
when both legs of an "if" statement begin with identical code.
3. Fix memory-barriers.txt section references.
4. Update the requirements design-level documentation to add
synchronize_rcu_mult().
5. Remove obsolete references to RCU-protected array indexes from
memory-barriers.txt.
6. Update memory-barriers.txt to explicitly state that
rcu_dereference() orders writes to as well as reads from
the RCU-protected data item.
7. Update memory-barriers.txt to distinguish between local and
global transitivity.
8. Update memory-barriers.txt to add alternative outcome from
release-acquire chain.
9. Add design-level documentation for RCU's major data structures.
10. Update the requirements design-level documentation to explain
why rcu_read_lock() needs no barrier() for PREEMPT=n.
11. Remove misleading statement that transitivity is cumulativity
from memory-barriers.txt.
12. Update the requirements design-level documentation to explicitly
state that it is illegal to invoke call_rcu() from an offline CPU.
13. Add text to the design-level documentation for RCU's major data
structures stating how the combining tree keeps lock contention
under control.
14. Clarify compiler store-fusion example in memory-barriers.txt.
Thanx, Paul
------------------------------------------------------------------------
RCU/Design/Data-Structures/BigTreeClassicRCU.svg | 474 ++++
RCU/Design/Data-Structures/BigTreeClassicRCUBH.svg | 499 ++++
RCU/Design/Data-Structures/BigTreeClassicRCUBHdyntick.svg | 695 +++++
RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntick.svg | 741 ++++++
RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntickCB.svg | 858 +++++++
RCU/Design/Data-Structures/Data-Structures.html | 1395 ++++++++++++
RCU/Design/Data-Structures/Data-Structures.htmlx | 1295 +++++++++++
RCU/Design/Data-Structures/HugeTreeClassicRCU.svg | 939 ++++++++
RCU/Design/Data-Structures/TreeLevel.svg | 828 +++++++
RCU/Design/Data-Structures/TreeMapping.svg | 305 ++
RCU/Design/Data-Structures/TreeMappingLevel.svg | 380 +++
RCU/Design/Data-Structures/blkd_task.svg | 843 +++++++
RCU/Design/Data-Structures/nxtlist.svg | 396 +++
RCU/Design/Requirements/Requirements.html | 235 +-
RCU/Design/Requirements/Requirements.htmlx | 121 +
memory-barriers.txt | 141 -
16 files changed, 10074 insertions(+), 71 deletions(-)