Re: [PATCH tip/core/rcu 0/52] Remove rcu_state pointers for v4.20/v5.0

From: Paul E. McKenney
Date: Thu Aug 30 2018 - 13:10:16 EST


On Thu, Aug 30, 2018 at 11:44:52AM -0400, Steven Rostedt wrote:
> On Wed, 29 Aug 2018 21:10:17 -0700
> "Paul E. McKenney" <paulmck@xxxxxxxxxxxxxxxxxx> wrote:
>
> > On Wed, Aug 29, 2018 at 08:22:16PM -0700, Paul E. McKenney wrote:
> > > On Wed, Aug 29, 2018 at 10:00:26PM -0400, Steven Rostedt wrote:
> > > > On Wed, 29 Aug 2018 15:38:30 -0700
> > > > "Paul E. McKenney" <paulmck@xxxxxxxxxxxxxxxxxx> wrote:
> > > >
> > > > > Hello!
> > > > >
> > > > > This commit does RCU-consolidation cleanups that get rid of pointers to
> > > > > the sole remaining rcu_state structure:
> > > > >
> > > > > 1-40: Remove the "rsp" parameter from numerous functions, given that
> > > > > the corresponding argument will always be &rcu_state.
> > > >
> > > > Hmm, couldn't 1-40 have been made into a single patch?
> > >
> > > They could. I separated them to make finding the inevitable typos easier.
> > > But at this point, it is easy enough to squash them together, though.
> >
> > And please see below for what the resulting diff would look like. Is
> > this an improvement?
>
> Somewhat...
>
> > ------------------------------------------------------------------------
> >
> > diff --git a/Documentation/RCU/Design/Data-Structures/Data-Structures.html b/Documentation/RCU/Design/Data-Structures/Data-Structures.html
> > index f5120a00f511..772c26a3865a 100644
> > --- a/Documentation/RCU/Design/Data-Structures/Data-Structures.html
> > +++ b/Documentation/RCU/Design/Data-Structures/Data-Structures.html
>
> I would just keep the documentation patches separate.

Combining yours and Josh's feedback, I will split the documentation
updates out of 4ca0508f7870 ("rcu: Remove rsp parameter from rcu_node tree
accessor macros") and put them into the "doc" series. Possibly combining
it with 2ea66b6fce61 ("doc: Update documentation for removal of RCU-bh
update machinery") and/or 3f38a4626202 ("doc: Update documentation for
removal of RCU-sched update machinery"). Left to myself, I would merge
it in to the merger of those two documentation commits. Having them
together is probably more convenient anyway, as it would provide a
summary of the entire RCU-flavor-consolidation change.

Fair enough?

Thanx, Paul

> -- Steve
>
>
> > @@ -1372,8 +1372,7 @@ that is, if the CPU is currently idle.
> > Accessor Functions</a></h3>
> >
> > <p>The following listing shows the
> > -<tt>rcu_get_root()</tt>, <tt>rcu_for_each_node_breadth_first</tt>,
> > -<tt>rcu_for_each_nonleaf_node_breadth_first()</tt>, and
> > +<tt>rcu_get_root()</tt>, <tt>rcu_for_each_node_breadth_first</tt> and
> > <tt>rcu_for_each_leaf_node()</tt> function and macros:
> >
> >
>