Skip to content

Documentation changes for 3.15

Paul E. McKenney lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest6 patches 13 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/6documentation: Document call_rcu() safety mechanisms and limitationsDocumentation/RCU/checklist.txt+14 -52 replies
2/6Documentation/memory-barriers.txt: ACCESS_ONCE() provides cache coherenceDocumentation/memory-barriers.txt+17 -02 replies
3/6Documentation/memory-barriers.txt: Conditional must use prior loadDocumentation/memory-barriers.txt+2 -10 replies
4/6Documentation/kernel-per-CPU-kthreads.txt: Workqueue affinityDocumentation/kernel-per-CPU-kthreads.txt+12 -10 replies
5/6Documentation/memory-barriers.txt: Need barriers() for some control dependenciesDocumentation/memory-barriers.txt+19 -78 replies
6/6documentation: Fix some inconsistencies in RTFP.txtDocumentation/RCU/RTFP.txt+125 -240 replies

Reviews trailers per patch

3 of 6 patches have a Reviewed-by or Acked-by of their own; the series has one for all of them.

PatchTejun HeoFrederic WeisbeckerLai JiangshanJosh Triplett
SeriesR-b
1/6R-b
2/6R-b
3/6
4/6R-b A-b R-b
5/6
6/6

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes. Scroll the table sideways for all 4 reviewers.

Read the v1 thread

Cover letter [PATCH tip/core/rcu 0/6] Documentation changes for 3.15

Hello!

This series provides a variety of documentation updates:

1. Update the documentation on actions to take to avoid frenetic
call_rcu() invocations from exhausting memory, including a mention of internal-to-RCU avoidance measures.

2. Add a note to Documentation/memory-barriers.txt stating that
ACCESS_ONCE() provides cache coherence for accesses to any single given variable.

3. Add an explicit statement that in control dependencies, the
condition must include the load in question.

4. Add WQ_SYSFS workqueues as a work-offloading option in
Documentation/kernel-per-CPU-kthreads.txt.

5. It turns out that some types of control dependencies require
memory barriers, most notably when the exact same store is at the beginning of both the then-clause and the else-clause. Document this.

6. Fixups to RTFP.txt

Thanx, Paul

------------------------------------------------------------------------

 Documentation/memory-barriers.txt           |   29 +++--
 b/Documentation/RCU/RTFP.txt                |  149 +++++++++++++++++++++++-----
 b/Documentation/RCU/checklist.txt           |   19 ++-
 b/Documentation/kernel-per-CPU-kthreads.txt |   13 ++
 b/Documentation/memory-barriers.txt         |   17 +++
 5 files changed, 189 insertions(+), 38 deletions(-)