]> git.proxmox.com Git - mirror_ubuntu-kernels.git/commit
tools/memory-model: Explain syntactic and semantic dependencies
authorAlan Stern <stern@rowland.harvard.edu>
Tue, 1 Feb 2022 19:00:08 +0000 (14:00 -0500)
committerPaul E. McKenney <paulmck@kernel.org>
Wed, 2 Feb 2022 01:32:30 +0000 (17:32 -0800)
commite2b665f612ca2ddc61c3d54817a3a780aee6b251
tree6f68cc0ecb6b18c353e079de9dd7f812516545d4
parentda123016ca8cb5697366c0b2dd55059b976e67e4
tools/memory-model: Explain syntactic and semantic dependencies

Paul Heidekrüger pointed out that the Linux Kernel Memory Model
documentation doesn't mention the distinction between syntactic and
semantic dependencies.  This is an important difference, because the
compiler can easily break dependencies that are only syntactic, not
semantic.

This patch adds a few paragraphs to the LKMM documentation explaining
these issues and illustrating how they can matter.

Suggested-by: Paul Heidekrüger <paul.heidekrueger@in.tum.de>
Reviewed-by: Akira Yokosawa <akiyks@gmail.com>
Signed-off-by: Alan Stern <stern@rowland.harvard.edu>
Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
tools/memory-model/Documentation/explanation.txt