wait_on_bit_lock_action(9)

💅 NAME 💅

wait_on_bit_lock_action — wait for a bit to be cleared, then set it

okay bestie, welcome to the wait_on_bit_lock_action(9) page from the Kernel API Manual — this one is genuinely so iconic ✨

---

✨ SYNOPSIS ✨

no cap, here’s the exact signature, copy it character for character:

       int wait_on_bit_lock_action (unsigned long *word , int bit ,
       wait_bit_action_f *action , unsigned mode );

---

🎀 ARGUMENTS 🎀

• word — the address containing the bit being waited on
• bit — the bit of the word being waited on and set
• action — the function used to sleep, which may take special actions
• mode — the task state to sleep in

---

🦋 DESCRIPTION 🦋

okay so this is similar to wait_on_bit_lock, but it calls action instead of schedule for the actual waiting. it’s giving “same vibe, different main character” 💅

the returned value will be zero if the bit was successfully set, in which case the call has the same memory sequencing semantics as test_and_clear_bit — or the error code returned by action if that call returned non-zero. periodt 🫶

---

🌈 SEE ALSO 🌈

kernel file: ./include/linux/wait_bit.h — and the whole friend group is here:

• wait_on_bit(9)
• wait_on_bit_io(9)
• wait_on_bit_timeout(9)
• wait_on_bit_action(9)
• wait_on_bit_lock(9)
• wait_on_bit_lock_io(9)
• wait_var_event(9)
• wait_var_event_io(9)
• wait_var_event_killable(9)
• wait_var_event_timeout(9)
• wait_var_event_interruptible(9)
• wait_var_event_any_lock(9)
• wait_var_event_spinlock(9)
• wait_var_event_mutex(9)
• wake_up_var_protected(9)
• wake_up_var_locked(9)
• clear_and_wake_up_bit(9)
• test_and_clear_wake_up_bit(9)
• atomic_dec_and_wake_up(9)
• store_release_wake_up(9)

---

that’s the whole wait_on_bit_lock_action(9) page from the ./include/linux source, dated October 2026 — byeee bestie, go slay some bits 🫶✨