Date: Sat, 16 Feb 2008 08:19:58 -0800
From: "Paul E. McKenney" <paulmck@linux.vnet.ibm.com>
To: Adrian Bunk <bunk@kernel.org>
Cc: linux-kernel@vger.kernel.org, davem@davemloft.net, dipankar@in.ibm.com
Subject: Re: [PATCH] Add list_for_each_rcu to features-removal list
Message-ID: <20080216161958.GC27468@linux.vnet.ibm.com>
Reply-To: paulmck@linux.vnet.ibm.com
References: <20080128122500.GA32723@linux.vnet.ibm.com> <20080216084723.GD9962@cs181133002.pp.htv.fi>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20080216084723.GD9962@cs181133002.pp.htv.fi>
User-Agent: Mutt/1.5.13 (2006-08-11)
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 2550
Lines: 61

On Sat, Feb 16, 2008 at 10:47:23AM +0200, Adrian Bunk wrote:
> On Mon, Jan 28, 2008 at 04:25:00AM -0800, Paul E. McKenney wrote:
> > Hello!
> > 
> > The list_for_each_entry_rcu() primitive should be used instead of
> > list_for_each_rcu(), as the former is easier to use and provides
> > better type safety.  This patch therefore adds list_for_each_rcu()
> > to the Documentation/feature-removal-schedule.txt file (for mid-2008)
> > and marks its comment header deprecated.
> > 
> > Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
> > ---
> > 
> >  Documentation/feature-removal-schedule.txt |   10 ++++++++++
> >  include/linux/list.h                       |    5 ++++-
> >  2 files changed, 14 insertions(+), 1 deletion(-)
> > 
> > diff -urpNa -X dontdiff linux-2.6.24/Documentation/feature-removal-schedule.txt linux-2.6.24-dep-lfeRCU/Documentation/feature-removal-schedule.txt
> > --- linux-2.6.24/Documentation/feature-removal-schedule.txt	2008-01-24 14:58:37.000000000 -0800
> > +++ linux-2.6.24-dep-lfeRCU/Documentation/feature-removal-schedule.txt	2008-01-28 04:00:49.000000000 -0800
> > @@ -333,3 +333,13 @@ Why:	This driver has been marked obsolet
> >  Who:	Stephen Hemminger <shemminger@linux-foundation.org>
> >  
> >  ---------------------------
> > +
> > +What:	list_for_each_rcu() primitive
> > +When:	July 2008
> > +Files:	include/linux/list.h
> > +Why:	The list_for_each_entry_rcu() primitive should be used instead,
> > +	as it is less error-prone and provides better type safety.
> > +Who:	Paul E. McKenney <paulmck@linux.vnet.ibm.com>
> >...
> 
> Declaring something as deprecated doesn't automatically convert the 
> in-kernel users.

Understood.

> And once there are no in-kernel users left you can kill it immediately.

Hmmm...  What is the purpose of Documentation/feature-removal-schedule.txt
in that case?

> The only working way for getting rid of list_for_each_rcu() is:
> - send patches for all in-kernel usages to the maintainers of the code
>   in question now

That has happened at least once.

> - once all of these patches have entered Linus' tree (which might not
>   be before the 2.6.26 merge window) you can remove list_for_each_rcu()

So your approach would be to mark the macro obsolete to prevent additional
uses in the meantime?

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