lkml.org 
[lkml]   [2013]   [Dec]   [19]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
SubjectRe: [PATCH v4 3/4] futex: Document ordering guarantees
From
Date
On Thu, 2013-12-19 at 15:05 -0800, Randy Dunlap wrote:
> On 12/19/13 13:07, Darren Hart wrote:
> > On Thu, 2013-12-19 at 13:00 -0800, Davidlohr Bueso wrote:
> >> On Thu, 2013-12-19 at 12:51 -0800, Randy Dunlap wrote:
> >>> On 12/19/13 12:45, Davidlohr Bueso wrote:
> >>>> From: Thomas Gleixner <tglx@linutronix.de>
> >>>>
> >>>> That's essential, if you want to hack on futexes.
> >>>>
> >>>> Cc: Ingo Molnar <mingo@kernel.org>
> >>>> Cc: Darren Hart <dvhart@linux.intel.com>
> >>>> Acked-by: Peter Zijlstra <peterz@infradead.org>
> >>>> Cc: Thomas Gleixner <tglx@linutronix.de>
> >>>> Cc: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
> >>>> Cc: Mike Galbraith <efault@gmx.de>
> >>>> Cc: Jeff Mahoney <jeffm@suse.com>
> >>>> Cc: Linus Torvalds <torvalds@linux-foundation.org>
> >>>> Cc: Scott Norton <scott.norton@hp.com>
> >>>> Cc: Tom Vaden <tom.vaden@hp.com>
> >>>> Cc: Aswin Chandramouleeswaran <aswin@hp.com>
> >>>> Cc: Waiman Long <Waiman.Long@hp.com>
> >>>> Cc: Jason Low <jason.low2@hp.com>
> >>>> Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
> >>>> Signed-off-by: Davidlohr Bueso <davidlohr@hp.com>
> >>>> ---
> >>>> kernel/futex.c | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >>>> 1 file changed, 57 insertions(+)
> >>>>
> >>>> diff --git a/kernel/futex.c b/kernel/futex.c
> >>>> index 577481d..af1fc31 100644
> >>>> --- a/kernel/futex.c
> >>>> +++ b/kernel/futex.c
> >>>> @@ -69,6 +69,63 @@
> >>>>
> >>>> #include "locking/rtmutex_common.h"
> >>>>
> >>>> +/*
> >>>> + * Basic futex operation and ordering guarantees:
> >>>> + *
> >>>> + * The waiter reads the futex value in user space and calls
> >>>> + * futex_wait(). It computes the hash bucket and acquires the hash
> >>>
> >>> does It
> >>> refer to "the waiter" or to futex_wait()?
> >>> I read it as referring to the waiter, but ISTM that the comments are using It
> >>> to refer to futex_wait()... ???
> >>>
> >>
> >> Yes, it refers to futex_wait(), which IMO in a futex context is pretty
> >> clear.
> >
> >
> > Agreed.
> >
> >
>
> I'll just have to get by with disagreeing with both of you then.
> I say that the pronoun's antecedent is ambiguous (unclear).
>

You are correct from a purely grammatical perspective, no argument
there. I just feel that the comment is clear enough from the context -
although perhaps people that hack on futexes should be excluded from
having an opinion here as we are biased :-)

If Davidlohr is going to resubmit for other reasons, then by all means,
please correct this per Randy's suggestion - I just didn't want to put
him (Davidlohr ;-) through another round of patches for this alone.

Thanks for ensuring our docs are as clear as possible Randy!

--
Darren Hart
Intel Open Source Technology Center
Yocto Project - Linux Kernel




\
 
 \ /
  Last update: 2013-12-20 00:41    [W:0.162 / U:0.112 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site