Skip to content

Documentation updates for v4.21/v5.0

Paul E. McKenney lkml 1 version New

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest20 patches 0 repliesNew

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/20doc: Set down forward-progress requirementsDocumentation/RCU/Design/Requirements/Requirements.html+108 -20 replies
2/20doc: Clarify RCU data-structure comment about rcu_tree fanoutDocumentation/RCU/Design/Data-Structures/Data-Structures.html+5 -30 replies
3/20doc: Remove rcu_preempt_state reference in stallwarnDocumentation/RCU/stallwarn.txt+2 -30 replies
4/20doc: rcu: Update information about resched_cpuDocumentation/RCU/Design/Expedited-Grace-Periods/Expedited-Grace-Periods.html+3 -30 replies
5/20doc: rcu: Remove rcu_dynticks from Data-StructuresDocumentation/RCU/Design/Data-Structures/BigTreeClassicRCUBHdyntick.svg Documentation/RCU/Design/Data-Structures/Data-Structures.html+25 -7600 replies
6/20doc: rcu: Update Data-Structures for RCU flavor consolidationDocumentation/RCU/Design/Data-Structures/BigTreeClassicRCUBH.svg Documentation/RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntick.svg Documentation/RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntickCB.svg +2 more+559 -22400 replies
7/20doc: rcu: Better clarify the rcu_segcblist ->len fieldDocumentation/RCU/Design/Data-Structures/Data-Structures.html+15 -80 replies
8/20doc: rcu: Update description of gp_seq fields in rcu_dataDocumentation/RCU/Design/Data-Structures/Data-Structures.html+4 -30 replies
9/20doc: Document rcutorture forward-progress test kernel parametersDocumentation/admin-guide/kernel-parameters.txt+17 -00 replies
10/20doc: rcu: Update core and full API in whatisRCUDocumentation/RCU/whatisRCU.txt+28 -270 replies
11/20doc: rcu: Add more rationale for using rcu_read_lock_sched in checklistDocumentation/RCU/checklist.txt+1 -10 replies
12/20doc: rcu: Remove obsolete suggestion from checklistDocumentation/RCU/checklist.txt+1 -50 replies
13/20doc: rcu: Remove obsolete checklist item about synchronize_rcu usageDocumentation/RCU/checklist.txt+7 -300 replies
14/20doc: rcu: Encourage use of rcu_barrier in checklistDocumentation/RCU/checklist.txt+2 -20 replies
15/20doc: Make reader aware of rcu_dereference_protectedDocumentation/RCU/whatisRCU.txt+14 -10 replies
16/20doc: Remove obsolete (non-)requirement about disabling preemptionDocumentation/RCU/Design/Requirements/Requirements.html+0 -500 replies
17/20doc: Make listing in RCU perf/scale requirements use rcu_assign_pointer()Documentation/RCU/Design/Requirements/Requirements.html+1 -10 replies
18/20doc: RCU scheduler spinlock rcu_read_unlock() restriction remainsDocumentation/RCU/Design/Requirements/Requirements.html+29 -150 replies
19/20doc: Correct parameter in stallwarnDocumentation/RCU/stallwarn.txt+1 -10 replies
20/20doc: Fix "struction" typo in RCU memory-ordering documentationDocumentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.html+1 -10 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH tip/core/rcu 0/20] Documentation updates for v4.21/v5.0

Hello!

This series provides documentation updates:

1. Set down forward-progress requirements.

2. Clarify RCU data-structure comment about rcu_tree fanout,
courtesy of Joel Fernandes.

3. Remove rcu_preempt_state reference in stallwarn, courtesy of
Joel Fernandes.

4. Update information about resched_cpu, courtesy of Joel Fernandes.

5. Remove rcu_dynticks from Data-Structures, courtesy of Joel
Fernandes.

6. Update Data-Structures for RCU flavor consolidation, courtesy of
Joel Fernandes.

7. Better clarify the rcu_segcblist ->len field, courtesy of Joel
Fernandes.

8. Update description of gp_seq fields in rcu_data, courtesy of
Joel Fernandes.

9. Document rcutorture forward-progress test kernel parameters.

10. Update core and full API in whatisRCU, courtesy of Joel Fernandes.

11. Add more rationale for using rcu_read_lock_sched() in checklist,
courtesy of Joel Fernandes.

12. Remove obsolete suggestion from checklist, courtesy of Joel
Fernandes.

13. Remove obsolete checklist item about synchronize_rcu() usage,
courtesy of Joel Fernandes.

14. Encourage use of rcu_barrier in checklist, courtesy of Joel
Fernandes.

15. Make reader aware of rcu_dereference_protected(), courtesy of
Joel Fernandes.

16. Remove obsolete (non-)requirement about disabling preemption,
courtesy of Joel Fernandes.

17. Make listing in RCU perf/scale requirements use rcu_assign_pointer(),
courtesy of Joel Fernandes.

18. RCU scheduler spinlock rcu_read_unlock() restriction remains.

19. Correct the parameter in stallwarn, courtesy of Joel Fernandes.

20. Fix "struction" typo in RCU memory-ordering documentation,
courtesy of Joel Fernandes.

Thanx, Paul

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

 Documentation/RCU/Design/Data-Structures/BigTreeClassicRCUBH.svg                |  499 -----
 Documentation/RCU/Design/Data-Structures/BigTreeClassicRCUBHdyntick.svg         |  695 --------
 Documentation/RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntick.svg         |  741 --------
 b/Documentation/RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntickCB.svg     |  834 +++-------
 b/Documentation/RCU/Design/Data-Structures/Data-Structures.html                 |  177 --
 b/Documentation/RCU/Design/Data-Structures/blkd_task.svg                        |  676 ++------
 b/Documentation/RCU/Design/Expedited-Grace-Periods/Expedited-Grace-Periods.html |    6 
 b/Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.html        |    2 
 b/Documentation/RCU/Design/Requirements/Requirements.html                       |  206 +-
 b/Documentation/RCU/checklist.txt                                               |   49 
 b/Documentation/RCU/stallwarn.txt                                               |    7 
 b/Documentation/RCU/whatisRCU.txt                                               |   70 
 b/Documentation/admin-guide/kernel-parameters.txt                               |   17 
 13 files changed, 823 insertions(+), 3156 deletions(-)