lkml.org 
[lkml]   [2018]   [Feb]   [2]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH 1/2] tools/memory-model: clarify the origin/scope of the tool name
On Thu, Feb 01, 2018 at 03:09:41PM -0800, Paul E. McKenney wrote:
> On Thu, Feb 01, 2018 at 10:26:50AM -0500, Alan Stern wrote:
> > On Thu, 1 Feb 2018, Andrea Parri wrote:
> >
> > > Ingo pointed out that:
> > >
> > > "The "memory model" name is overly generic, ambiguous and somewhat
> > > misleading, as we usually mean the virtual memory layout/model
> > > when we say "memory model". GCC too uses it in that sense [...]"
> > >
> > > Make it clearer that, in the context of tools/memory-model/, the term
> > > "memory-model" is used as shorthand for "memory consistency model" by
> > > calling out this convention in tools/memory-model/README.
> > >
> > > Stick to the full name in sources' headers and for the subsystem name.
> > >
> > > Suggested-by: Ingo Molnar <mingo@kernel.org>
> > > Signed-off-by: Andrea Parri <parri.andrea@gmail.com>
> >
> > For both patches:
> >
> > Acked-by: Alan Stern <stern@rowland.harvard.edu>
>
> Thank you all -- I have queued this and pushed it to my RCU tree on
> branch lkmm. I did reword the commit log a bit, please see below and
> please let me know if any of my rewordings need halp.
>
> Andrea, when you resend your second patch, could you please add Alan's
> Acked-by?

You mean in order to integrate Will's suggestion? I was planning to send
that as a separate patch, as suggested by Will: the patch is on its way,
IAC, please let me know if you'd prefer a V2 merging the two changes.

Andrea


>
> Thanx, Paul
>
> ------------------------------------------------------------------------
>
> commit de175b697f71b8e3e6d980b7186b909fee0c4378
> Author: Andrea Parri <parri.andrea@gmail.com>
> Date: Thu Feb 1 13:03:29 2018 +0100
>
> tools/memory-model: Clarify the origin/scope of the tool name
>
> Ingo pointed out that:
>
> "The "memory model" name is overly generic, ambiguous and somewhat
> misleading, as we usually mean the virtual memory layout/model
> when we say "memory model". GCC too uses it in that sense [...]"
>
> Make it clearer that tools/memory-model/ uses the term "memory model"
> is used as shorthand for "memory consistency model" by calling out this
> convention in tools/memory-model/README.
>
> Stick to the original "memory model" term in sources' headers and for
> the subsystem name.
>
> Suggested-by: Ingo Molnar <mingo@kernel.org>
> Signed-off-by: Andrea Parri <parri.andrea@gmail.com>
> Acked-by: Will Deacon <will.deacon@arm.com>
> Acked-by: Alan Stern <stern@rowland.harvard.edu>
> Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
>
> diff --git a/tools/memory-model/MAINTAINERS b/tools/memory-model/MAINTAINERS
> index 711cbe72d606..db3bd3fc0435 100644
> --- a/tools/memory-model/MAINTAINERS
> +++ b/tools/memory-model/MAINTAINERS
> @@ -1,4 +1,4 @@
> -LINUX KERNEL MEMORY MODEL
> +LINUX KERNEL MEMORY CONSISTENCY MODEL
> M: Alan Stern <stern@rowland.harvard.edu>
> M: Andrea Parri <parri.andrea@gmail.com>
> M: Will Deacon <will.deacon@arm.com>
> diff --git a/tools/memory-model/README b/tools/memory-model/README
> index 43ba49492111..91414a49fac5 100644
> --- a/tools/memory-model/README
> +++ b/tools/memory-model/README
> @@ -1,15 +1,15 @@
> - =========================
> - LINUX KERNEL MEMORY MODEL
> - =========================
> + =====================================
> + LINUX KERNEL MEMORY CONSISTENCY MODEL
> + =====================================
>
> ============
> INTRODUCTION
> ============
>
> -This directory contains the memory model of the Linux kernel, written
> -in the "cat" language and executable by the (externally provided)
> -"herd7" simulator, which exhaustively explores the state space of
> -small litmus tests.
> +This directory contains the memory consistency model (memory model, for
> +short) of the Linux kernel, written in the "cat" language and executable
> +by the externally provided "herd7" simulator, which exhaustively explores
> +the state space of small litmus tests.
>
> In addition, the "klitmus7" tool (also externally provided) may be used
> to convert a litmus test to a Linux kernel module, which in turn allows
> diff --git a/tools/memory-model/linux-kernel.bell b/tools/memory-model/linux-kernel.bell
> index 57112505f5e0..b984bbda01a5 100644
> --- a/tools/memory-model/linux-kernel.bell
> +++ b/tools/memory-model/linux-kernel.bell
> @@ -11,7 +11,7 @@
> * which is to appear in ASPLOS 2018.
> *)
>
> -"Linux kernel memory model"
> +"Linux-kernel memory consistency model"
>
> enum Accesses = 'once (*READ_ONCE,WRITE_ONCE,ACCESS_ONCE*) ||
> 'release (*smp_store_release*) ||
> diff --git a/tools/memory-model/linux-kernel.cat b/tools/memory-model/linux-kernel.cat
> index 15b7a5dd8a9a..babe2b3b0bb3 100644
> --- a/tools/memory-model/linux-kernel.cat
> +++ b/tools/memory-model/linux-kernel.cat
> @@ -11,7 +11,7 @@
> * which is to appear in ASPLOS 2018.
> *)
>
> -"Linux kernel memory model"
> +"Linux-kernel memory consistency model"
>
> (*
> * File "lock.cat" handles locks and is experimental.
>

\
 
 \ /
  Last update: 2018-02-02 09:55    [W:0.057 / U:0.412 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site