ee20260136
This commit upgrades LKMM documentation, perhaps most notably adding a number of litmus tests illustrating cmpxchg() ordering properties. TL;DR: Failing cmpxchg() operations provide no ordering. -----BEGIN PGP SIGNATURE----- iQJHBAABCgAxFiEEbK7UrM+RBIrCoViJnr8S83LZ+4wFAmY+jIsTHHBhdWxtY2tA a2VybmVsLm9yZwAKCRCevxLzctn7jJ5ED/4stpGm2O13qUKtMwOmVaXJNozLQnaC bvmWL9ZJm1sSmI+EnQPdiNi0k7F3IyURHMkE7gt/a7EcgHMZIuxXyiRFueDJ2yLl ewKalp2xEYd0i0xI0KfTdjEZm2y6V1C6i7rDWY+Wnws3RKFFjQ4+3/xjGlO2fV0v NNbqHK0mfwrNs/tNppcOnvcwxHnI/B6MHthavmSU3bt8dfLL98KvTRwfpUJdb0Fa I6KSeXY/d4+8TjXiU6+bU7AvkxTNA84nDo2dbciGKlcG661lUl/dUtK8I+pwCErW ZMlN4HwsYcHf8z9lyJZIIKD3k3s58jdvRCvB5eJrTDwvb0chQT1OFmzzPBhJLiVr P04eptnxAq6BCG/UkegNQY6DvP9TwkhvbiwQw/uSGrycnOQT2pBK52yrdlGgffvr 3TvUNeQV51czXSVkgIQRH8oznVEjKKycgVxcPbBtZshbRhNZX6WBDJAzlzYKqJOc 9Bi735+jaYDjAPnSyRgYJiQRPe3kfoOzba9YsXmTwoHPSl7wVbl4aE3SgmQ1e8sQ SEKIEJmhv8OFRiWpVq0C7AU6nCOvLvRNCYi5bpZPyHmKRY231n7ACH6Hxto5xsGj Gnhc1ZjWYQJo/LKNo5YTNVeDBLCebbEVfsed3U1c7Qc3ae1Toc19uzLIgqU/vhZu UJfgkiGnWTFYIA== =qh1W -----END PGP SIGNATURE----- Merge tag 'lkmm.2024.05.10a' of git://git.kernel.org/pub/scm/linux/kernel/git/paulmck/linux-rcu Pull LKMM documentation updates from Paul McKenney: "This upgrades LKMM documentation, perhaps most notably adding a number of litmus tests illustrating cmpxchg() ordering properties. TL;DR: Failing cmpxchg() operations provide no ordering" * tag 'lkmm.2024.05.10a' of git://git.kernel.org/pub/scm/linux/kernel/git/paulmck/linux-rcu: Documentation/litmus-tests: Make cmpxchg() tests safe for klitmus Documentation/atomic_t: Emphasize that failed atomic operations give no ordering Documentation/litmus-tests: Demonstrate unordered failing cmpxchg Documentation/litmus-tests: Add locking tests to README
Linux kernel
============
There are several guides for kernel developers and users. These guides can
be rendered in a number of formats, like HTML and PDF. Please read
Documentation/admin-guide/README.rst first.
In order to build the documentation, use ``make htmldocs`` or
``make pdfdocs``. The formatted documentation can also be read online at:
https://www.kernel.org/doc/html/latest/
There are various text files in the Documentation/ subdirectory,
several of them using the reStructuredText markup notation.
Please read the Documentation/process/changes.rst file, as it contains the
requirements for building and running the kernel, and information about
the problems which may result by upgrading your kernel.