lkml.org 
[lkml]   [2016]   [Feb]   [24]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
Subject[PATCH tip/core/rcu 0/14] Documentation updates for 4.6
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(-)

\
 
 \ /
  Last update: 2016-02-24 06:21    [W:0.200 / U:0.736 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site