Subject: Re: [PATCH v2] Documentation: rw_lock lessons learned

From: Stephen Hemminger <[email-masked]>
Date: Thu, 12 Nov 2009 15:00:29 -0800

On Thu, 12 Nov 2009 14:13:03 -0500
Stephen Clark <[email-masked]> wrote:

> William Allen Simpson wrote:
> > In recent weeks, two different network projects erroneously
> > strayed down the rw_lock path.  Update the Documentation
> > based upon comments by Eric Dumazet and Paul E. McKenney in
> > those threads.
> > 
> > Merged with editorial changes by Stephen Hemminger.
> > 
> > Signed-off-by: [email-masked]
> > Acked-by: Paul E. McKenney <[email-masked]>
> > ---
> >  Documentation/spinlocks.txt |  186 
> > ++++++++++++++++++++-----------------------
> >  1 files changed, 86 insertions(+), 100 deletions(-)
> > 
> 
> How up to date is this doc?
> 
> http://www.kernel.org/pub/linux/kernel/people/rusty/kernel-locking/index.html
> 

Out of date.
1. Missing mutex's which have largely replaced semaphores.

2. Missing change to lock initialization in later kernels.

3. Missing description of lock dependency checker which should be in same guide.