Re: while_each_thread() under rcu_read_lock() is broken?

From: Paul E. McKenney
Date: Fri Jul 09 2010 - 12:18:56 EST


On Thu, Jul 08, 2010 at 06:01:37PM -0700, Roland McGrath wrote:
> > Hmmm... The kerneldoc for rcu_read_lock() looks like it says this
> > pretty unambiguously. Then again, that is easy for me to say, given
> > that I was the one who made most of this stuff up. ;-)
>
> Yeah, well, I thought I knew what rcu_read_lock did and the only new thing
> I had in mind was using call_rcu, so that's the only place I looked. It
> wasn't entirely unreasonable to have to read through Documentation/RCU/ a
> bit for a subtlety of this kind, and I did find it quickly enough once
> Oleg's attentiveness alerted me to be freshly afraid of the subtleties.
>
> > But it has been awhile since I looked after the kerneldoc. Please see
> > below for the changes I would make if left to myself.
>
> Those look good to me!

Very good, I have them queued. I have some messy dependencies in my
tree, so it will take some time for them to appear.

> > Any other suggestions for improvement to the kerneldoc?
>
> Oh, I don't know, send over someone to read it to me in a sultry voice
> so I get appropriately motivated to cast about for all of it I can find
> and listen closely to every word? It already looks like if I'd actually
> read all of it twice that day, I would have had the information I needed.

Hmmm... Despite being happily married for well over two decades, I do
feel the need to advise you to be careful what you wish for. ;-)

Thanx, Paul
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/