kernel/linux.git/tools/memory-model/Documentation/locking.txt, branch v6.19.11Linux kernel stable tree (mirror)https://git.radix-linux.su/kernel/linux.git/atom?h=v6.19.112025-04-22T18:21:46+00:00tools/memory-model: docs/README: Update introduction of locking.txt2025-04-22T18:21:46+00:00Akira Yokosawaakiyks@gmail.com2025-03-14T11:10:30+00:00urn:sha1:13a9a11358bce755bd602346fa7f56690b68c267
Commit 9bc931e9e161 ("tools/memory-model: Add locking.txt and
glossary.txt to README") failed to mention the relation of the "Locking"
section in recipes.txt and locking.txt.
The latter is a detailed version of the former intended to be read on
its own.
Reword the description in README and add notes in locking.txt and
recipes.txt to clarify their relationship.
[ paulmck: Wordsmithing. ]
Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
Acked-by: Andrea Parri <parri.andrea@gmail.com>
tools/memory-model: Document locking corner cases2023-03-24T17:22:25+00:00Paul E. McKenneypaulmck@kernel.org2020-08-14T23:14:34+00:00urn:sha1:7e7eb5ae4e4cd482a1ebc6a82ea8a04c5ead62ee
Most Linux-kernel uses of locking are straightforward, but there are
corner-case uses that rely on less well-known aspects of the lock and
unlock primitives. This commit therefore adds a locking.txt and litmus
tests in Documentation/litmus-tests/locking to explain these corner-case
uses.
[ paulmck: Apply Andrea Parri feedback for klitmus7. ]
[ paulmck: Apply Akira Yokosawa example-consistency feedback. ]
Reviewed-by: Akira Yokosawa <akiyks@gmail.com>
Signed-off-by: Paul E. McKenney <paulmck@kernel.org>