linux.git/Documentation/RCU, branch v6.8

doc: Mention address and data dependencies in rcu_dereference.rst

2023-12-13T19:46:28+00:00

This commit adds discussion of address and data dependencies to the
beginning of rcu_dereference.rst in order to enable readers to more
easily make the connection to the Linux-kernel memory model in general
and to memory-barriers.txt in particular.

Reported-by: Jonas Oberhauser 
Reported-by: Akira Yokosawa 
Signed-off-by: Paul E. McKenney 
Signed-off-by: Neeraj Upadhyay (AMD)

doc: Clarify RCU Tasks reader/updater checklist

2023-12-13T19:45:52+00:00

Currently, the reader/updater compatibility rules for the three RCU
Tasks flavors are squished together in a single paragraph, which can
result in confusion.  This commit therefore splits them out into a list,
clearly showing the distinction between these flavors.

Link: https://lore.kernel.org/all/20231002211936.5948253e@gandalf.local.home/

Reported-by: Steven Rostedt 
Signed-off-by: Paul E. McKenney 
Reviewed-by: Mathieu Desnoyers 
Reviewed-by: Steven Rostedt (Google) 
Signed-off-by: Neeraj Upadhyay (AMD)

Documentation: RCU: Remove repeated word in comments

2023-12-13T19:44:10+00:00

Remove the repeated word "of" in comments.

Signed-off-by: Charles Han 
Signed-off-by: Paul E. McKenney 
Signed-off-by: Neeraj Upadhyay (AMD)

Merge branches 'rcu/torture', 'rcu/fixes', 'rcu/docs', 'rcu/refscale', 'rcu/tasks' and 'rcu/stall' into rcu/next

2023-10-23T13:24:11+00:00

rcu/torture: RCU torture, locktorture and generic torture infrastructure
rcu/fixes: Generic and misc fixes
rcu/docs: RCU documentation updates
rcu/refscale: RCU reference scalability test updates
rcu/tasks: RCU tasks updates
rcu/stall: Stall detection updates

rcu: Standardize explicit CPU-hotplug calls

2023-10-04T20:29:45+00:00

rcu_report_dead() and rcutree_migrate_callbacks() have their headers in
rcupdate.h while those are pure rcutree calls, like the other CPU-hotplug
functions.

Also rcu_cpu_starting() and rcu_report_dead() have different naming
conventions while they mirror each other's effects.

Fix the headers and propose a naming that relates both functions and
aligns with the prefix of other rcutree CPU-hotplug functions.

Reviewed-by: Paul E. McKenney 
Signed-off-by: Frederic Weisbecker

rcu: Remove references to rcu_migrate_callbacks() from diagrams

2023-10-04T15:46:29+00:00

This function is gone since:

	53b46303da84 (rcu: Remove rsp parameter from rcu_boot_init_percpu_data() and friends)

Reviewed-by: Paul E. McKenney 
Signed-off-by: Frederic Weisbecker

rcu: Describe listRCU read-side guarantees

2023-09-11T21:09:35+00:00

More explicitly state what is, and what is not guaranteed to those
who iterate a list while protected by RCU.

[ paulmck: Apply Joel Fernandes feedback. ]

Signed-off-by: Matthew Wilcox (Oracle) 
Reviewed-by: Joel Fernandes (Google) 
Signed-off-by: Paul E. McKenney 
Signed-off-by: Frederic Weisbecker

Documentation: RCU: Fix section numbers after adding Section 7 in whatisRCU.rst

2023-09-11T21:08:45+00:00

Signed-off-by: Wei Zhang 
Reviewed-by: Randy Dunlap 
Signed-off-by: Paul E. McKenney 
Signed-off-by: Frederic Weisbecker

Docs/RCU/rculist_nulls: Fix text about atomic_set_release()

2023-07-14T21:55:57+00:00

The document says we can avoid extra _release() in insert function when
hlist_nulls is used, but that's not true[1].  Drop it.

[1] https://lore.kernel.org/rcu/46440869-644a-4982-b790-b71b43976c66@paulmck-laptop/

Signed-off-by: SeongJae Park 
Signed-off-by: Paul E. McKenney

Docs/RCU/rculist_nulls: Fix hlist_[nulls]_head field names of 'obj'

2023-07-14T21:55:56+00:00

The example code snippets on rculist_nulls.rst are assuming 'obj' to
have the 'hlist_head' or 'hlist_nulls_head' field named 'obj_node', but
a sentence and some code snippets are wrongly calling
'obj->obj_node.next' as 'obj->obj_next', or 'obj->obj_node' as 'member'.
Fix it.

Signed-off-by: SeongJae Park 
Signed-off-by: Paul E. McKenney