04 Sep, 2020

2 commits

  • Current LKMM documentation assumes that the reader already understands
    concurrency in the Linux kernel, which won't necessarily always be the
    case. This commit supplies a simple.txt file that provides a starting
    point for someone who is new to concurrency in the Linux kernel.
    That said, this file might also useful as a reminder to experienced
    developers of simpler approaches to dealing with concurrency.

    Link: Link: https://lwn.net/Articles/827180/
    [ paulmck: Apply feedback from Joel Fernandes. ]
    Co-developed-by: Dave Chinner
    Signed-off-by: Dave Chinner
    Co-developed-by: Paul E. McKenney
    Signed-off-by: Paul E. McKenney

    Paul E. McKenney
     
  • The current LKMM documentation says very little about litmus tests, and
    worse yet directs people to the herd7 documentation for more information.
    Now, the herd7 documentation is quite voluminous and educational,
    but it is intended for people creating and modifying memory models,
    not those attempting to use them.

    This commit therefore updates README and creates a litmus-tests.txt
    file that gives an overview of litmus-test format and describes ways of
    modeling various special cases, illustrated with numerous examples.

    [ paulmck: Add Alan Stern feedback. ]
    [ paulmck: Apply Dave Chinner feedback. ]
    [ paulmck: Apply Andrii Nakryiko feedback. ]
    [ paulmck: Apply Johannes Weiner feedback. ]
    Link: https://lwn.net/Articles/827180/
    Reported-by: Dave Chinner
    Acked-by: Peter Zijlstra (Intel)
    Signed-off-by: Paul E. McKenney

    Paul E. McKenney