korg/linux
0
0
Fork 0
mirror of https://mirrors.bfsu.edu.cn/git/linux.git synced 2024-11-26 05:34:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

tools/memory-model: Clarify the origin/scope of the tool name

Browse Source 
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 clear that tools/memory-model/ uses the term "memory model" 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>
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Acked-by: Peter Zijlstra <peterz@infradead.org>
Acked-by: Will Deacon <will.deacon@arm.com>
Acked-by: Alan Stern <stern@rowland.harvard.edu>
Cc: Linus Torvalds <torvalds@linux-foundation.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: akiyks@gmail.com
Cc: boqun.feng@gmail.com
Cc: dhowells@redhat.com
Cc: j.alglave@ucl.ac.uk
Cc: linux-arch@vger.kernel.org
Cc: luc.maranget@inria.fr
Cc: nborisov@suse.com
Cc: npiggin@gmail.com
Link: http://lkml.kernel.org/r/1519169112-20593-1-git-send-email-paulmck@linux.vnet.ibm.com
Signed-off-by: Ingo Molnar <mingo@kernel.org>
This commit is contained in:
Andrea Parri 2018-02-20 15:25:01 -08:00 committed by Ingo Molnar
parent 862e6e2a60
commit 48d44d4e8a
4 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
tools/memory-model/MAINTAINERS
View File

@ -1,4 +1,4 @@
LINUX KERNEL MEMORY MODEL LINUX KERNEL MEMORY CONSISTENCY MODEL
M: Alan Stern <stern@rowland.harvard.edu> M: Alan Stern <stern@rowland.harvard.edu>
M: Andrea Parri <parri.andrea@gmail.com> M: Andrea Parri <parri.andrea@gmail.com>
M: Will Deacon <will.deacon@arm.com> M: Will Deacon <will.deacon@arm.com>

14
tools/memory-model/README
View File

@ -1,15 +1,15 @@
========================= =====================================
LINUX KERNEL MEMORY MODEL LINUX KERNEL MEMORY CONSISTENCY MODEL
========================= =====================================
============ ============
INTRODUCTION INTRODUCTION
============ ============
This directory contains the memory model of the Linux kernel, written This directory contains the memory consistency model (memory model, for
in the "cat" language and executable by the (externally provided) short) of the Linux kernel, written in the "cat" language and executable
"herd7" simulator, which exhaustively explores the state space of by the externally provided "herd7" simulator, which exhaustively explores
small litmus tests. the state space of small litmus tests.
In addition, the "klitmus7" tool (also externally provided) may be used 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 to convert a litmus test to a Linux kernel module, which in turn allows

2
tools/memory-model/linux-kernel.bell
View File

@ -11,7 +11,7 @@
* which is to appear in ASPLOS 2018. * 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*) || enum Accesses = 'once (*READ_ONCE,WRITE_ONCE,ACCESS_ONCE*) ||
'release (*smp_store_release*) || 'release (*smp_store_release*) ||

2
tools/memory-model/linux-kernel.cat
View File

@ -11,7 +11,7 @@
* which is to appear in ASPLOS 2018. * which is to appear in ASPLOS 2018.
*) *)
"Linux kernel memory model" "Linux-kernel memory consistency model"
(* (*
* File "lock.cat" handles locks and is experimental. * File "lock.cat" handles locks and is experimental.