lkml.org 
[lkml]   [2020]   [May]   [12]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    Subject[PATCH RESEND 3/4] Documentation/litmus-tests: Merge atomic's README into top-level one
    From
    Date
    From 96fa6680e3b990633ecbb6d11acf03a161b790bd Mon Sep 17 00:00:00 2001
    From: Akira Yokosawa <akiyks@gmail.com>
    Date: Sun, 10 May 2020 15:12:57 +0900
    Subject: [PATCH RESEND 3/4] Documentation/litmus-tests: Merge atomic's README into top-level one

    Where Documentation/litmus-tests/README lists RCU litmus tests,
    Documentation/litmus-tests/atomic/README lists atomic litmus tests.
    For symmetry, merge the latter into former, with some context
    adjustment in the introduction.

    Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
    Acked-by: Andrea Parri <parri.andrea@gmail.com>
    Acked-by: Joel Fernandes (Google) <joel@joelfernandes.org>
    ---
    Documentation/litmus-tests/README | 19 +++++++++++++++++++
    Documentation/litmus-tests/atomic/README | 16 ----------------
    2 files changed, 19 insertions(+), 16 deletions(-)
    delete mode 100644 Documentation/litmus-tests/atomic/README

    diff --git a/Documentation/litmus-tests/README b/Documentation/litmus-tests/README
    index c4307ea9f996..ac0b270b456c 100644
    --- a/Documentation/litmus-tests/README
    +++ b/Documentation/litmus-tests/README
    @@ -2,6 +2,25 @@
    LITMUS TESTS
    ============

    +Each subdirectory contains litmus tests that are typical to describe the
    +semantics of respective kernel APIs.
    +For more information about how to "run" a litmus test or how to generate
    +a kernel test module based on a litmus test, please see
    +tools/memory-model/README.
    +
    +
    +atomic (/atomic derectory)
    +--------------------------
    +
    +Atomic-RMW+mb__after_atomic-is-stronger-than-acquire.litmus
    + Test that an atomic RMW followed by a smp_mb__after_atomic() is
    + stronger than a normal acquire: both the read and write parts of
    + the RMW are ordered before the subsequential memory accesses.
    +
    +Atomic-RMW-ops-are-atomic-WRT-atomic_set.litmus
    + Test that atomic_set() cannot break the atomicity of atomic RMWs.
    +
    +
    RCU (/rcu directory)
    --------------------

    diff --git a/Documentation/litmus-tests/atomic/README b/Documentation/litmus-tests/atomic/README
    deleted file mode 100644
    index 714cf93816ea..000000000000
    --- a/Documentation/litmus-tests/atomic/README
    +++ /dev/null
    @@ -1,16 +0,0 @@
    -This directory contains litmus tests that are typical to describe the semantics
    -of our atomic APIs. For more information about how to "run" a litmus test or
    -how to generate a kernel test module based on a litmus test, please see
    -tools/memory-model/README.
    -
    -============
    -LITMUS TESTS
    -============
    -
    -Atomic-RMW+mb__after_atomic-is-stronger-than-acquire
    - Test that an atomic RMW followed by a smp_mb__after_atomic() is
    - stronger than a normal acquire: both the read and write parts of
    - the RMW are ordered before the subsequential memory accesses.
    -
    -Atomic-RMW-ops-are-atomic-WRT-atomic_set.litmus
    - Test that atomic_set() cannot break the atomicity of atomic RMWs.
    --
    2.17.1

    \
     
     \ /
      Last update: 2020-05-12 23:39    [W:5.853 / U:0.044 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site