Commit 4a4e0199 authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge tag 'lkmm.2025.12.01a' of git://git.kernel.org/pub/scm/linux/kernel/git/paulmck/linux-rcu 

Pull lkmm documentation update from Paul McKenney:

 - Sort the memory-barriers.txt file's wait_event* and wait_on_bit* list
   alphabetically

* tag 'lkmm.2025.12.01a' of git://git.kernel.org/pub/scm/linux/kernel/git/paulmck/linux-rcu:
  memory-barriers.txt: Sort wait_event* and wait_on_bit* list alphabetically
parents 98e7dcbb 7f8fcc6f

Documentation/memory-barriers.txt

+3 −3
Original line number Diff line number Diff line
@@ -2182,9 +2182,11 @@ set_current_state() may be wrapped by: 


which therefore also imply a general memory barrier after setting the state.

The whole sequence above is available in various canned forms, all of which

interpolate the memory barrier in the right place:

interpolate the memory barrier in the right place, for example:



	wait_event();

	wait_event_cmd();

	wait_event_exclusive_cmd();

	wait_event_interruptible();

	wait_event_interruptible_exclusive();

	wait_event_interruptible_timeout();
@@ -2192,8 +2194,6 @@ interpolate the memory barrier in the right place: 
	wait_event_timeout();

	wait_on_bit();

	wait_on_bit_lock();

	wait_event_cmd();

	wait_event_exclusive_cmd();





Secondly, code that performs a wake up normally follows something like this: