]> www.infradead.org Git - users/willy/linux.git/commit
tools/memory-model: Document herd7 (abstract) representation
authorAndrea Parri <parri.andrea@gmail.com>
Wed, 19 Jun 2024 01:06:04 +0000 (03:06 +0200)
committerPaul E. McKenney <paulmck@kernel.org>
Sat, 14 Sep 2024 06:56:43 +0000 (23:56 -0700)
commite8adbac0d44fe5f275902c004d04b0cfc33fce8d
tree75adfe273726c0ab49ccce61570c6899bdf1b62a
parent8400291e289ee6b2bf9779ff1c83a291501f017b
tools/memory-model: Document herd7 (abstract) representation

The Linux-kernel memory model (LKMM) source code and the herd7 tool are
closely linked in that the latter is responsible for (pre)processing
each C-like macro of a litmus test, and for providing the LKMM with a
set of events, or "representation", corresponding to the given macro.
This commit therefore provides herd-representation.txt to document
the representations of the concurrency macros, following their
"classification" in Documentation/atomic_t.txt.

Link: https://lore.kernel.org/all/ZnFZPJlILp5B9scN@andrea/
Suggested-by: Hernan Ponce de Leon <hernan.poncedeleon@huaweicloud.com>
Signed-off-by: Andrea Parri <parri.andrea@gmail.com>
Reviewed-by: Boqun Feng <boqun.feng@gmail.com>
Reviewed-by: Hernan Ponce de Leon <hernan.poncedeleon@huaweicloud.com>
Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
tools/memory-model/Documentation/README
tools/memory-model/Documentation/herd-representation.txt [new file with mode: 0644]