aboutsummaryrefslogtreecommitdiffstats
path: root/tools
diff options
context:
space:
mode:
authorAndrea Parri <parri.andrea@gmail.com>2018-02-20 18:25:01 -0500
committerIngo Molnar <mingo@kernel.org>2018-02-21 03:58:12 -0500
commit48d44d4e8a583c66d9f376e18c1a1fcc445f4b64 (patch)
tree36d58233b049b32ef7dbfa7e40a0c5a794be70ee /tools
parent862e6e2a609197f41bc04420b31ff122be9f870f (diff)
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 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>
Diffstat (limited to 'tools')
-rw-r--r--tools/memory-model/MAINTAINERS2
-rw-r--r--tools/memory-model/README14
-rw-r--r--tools/memory-model/linux-kernel.bell2
-rw-r--r--tools/memory-model/linux-kernel.cat2
4 files changed, 10 insertions, 10 deletions
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 @@
1LINUX KERNEL MEMORY MODEL 1LINUX KERNEL MEMORY CONSISTENCY MODEL
2M: Alan Stern <stern@rowland.harvard.edu> 2M: Alan Stern <stern@rowland.harvard.edu>
3M: Andrea Parri <parri.andrea@gmail.com> 3M: Andrea Parri <parri.andrea@gmail.com>
4M: Will Deacon <will.deacon@arm.com> 4M: 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 @@
1 ========================= 1 =====================================
2 LINUX KERNEL MEMORY MODEL 2 LINUX KERNEL MEMORY CONSISTENCY MODEL
3 ========================= 3 =====================================
4 4
5============ 5============
6INTRODUCTION 6INTRODUCTION
7============ 7============
8 8
9This directory contains the memory model of the Linux kernel, written 9This directory contains the memory consistency model (memory model, for
10in the "cat" language and executable by the (externally provided) 10short) of the Linux kernel, written in the "cat" language and executable
11"herd7" simulator, which exhaustively explores the state space of 11by the externally provided "herd7" simulator, which exhaustively explores
12small litmus tests. 12the state space of small litmus tests.
13 13
14In addition, the "klitmus7" tool (also externally provided) may be used 14In addition, the "klitmus7" tool (also externally provided) may be used
15to convert a litmus test to a Linux kernel module, which in turn allows 15to 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 @@
11 * which is to appear in ASPLOS 2018. 11 * which is to appear in ASPLOS 2018.
12 *) 12 *)
13 13
14"Linux kernel memory model" 14"Linux-kernel memory consistency model"
15 15
16enum Accesses = 'once (*READ_ONCE,WRITE_ONCE,ACCESS_ONCE*) || 16enum Accesses = 'once (*READ_ONCE,WRITE_ONCE,ACCESS_ONCE*) ||
17 'release (*smp_store_release*) || 17 '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 @@
11 * which is to appear in ASPLOS 2018. 11 * which is to appear in ASPLOS 2018.
12 *) 12 *)
13 13
14"Linux kernel memory model" 14"Linux-kernel memory consistency model"
15 15
16(* 16(*
17 * File "lock.cat" handles locks and is experimental. 17 * File "lock.cat" handles locks and is experimental.