atomic_notifier_call_chain(9)

💅 atomic_notifier_call_chain(9) — Kernel API Manual ✨

okay so bestie, welcome to the Kernel API Manual, section 9 — this page is literally about calling functions in an atomic notifier chain, and it ate. 🫶

🌸 NAME 🌸

atomic_notifier_call_chain — Call functions in an atomic notifier chain 💖

✨ SYNOPSIS ✨

       int atomic_notifier_call_chain (struct atomic_notifier_head *nh ,
       unsigned long val , void *v );

🎀 ARGUMENTS 🎀

• nh — Pointer to head of the atomic notifier chain. That’s the main character of this call, bestie. 👑
• val — Value passed unmodified to notifier function. Like, no edits, no filters — it goes through as-is. ✨
• v — Pointer passed unmodified to notifier function. Same vibe: untouched, unbothered. 🦋

💫 DESCRIPTION 💫

Calls each function in a notifier chain in turn. The functions run in an atomic context, so they must not block. 🚨 This routine uses RCU to synchronize with changes to the chain.

If the return value of the notifier can be and'ed with NOTIFY_STOP_MASK then atomic_notifier_call_chain will return immediately, with the return value of the notifier function which halted execution. Otherwise the return value is the return value of the last notifier function called. 💅

okay but fr fr: “atomic context” means no blocking, bestie — that part is not a drill. 😭

👀 SEE ALSO 👀

• Kernel file ./kernel/notifier.c
• notifier_call_chain(9)
• notifier_call_chain_robust(9)
• atomic_notifier_chain_register(9)
• atomic_notifier_chain_register_unique_prio(9)
• atomic_notifier_chain_unregister(9)
• atomic_notifier_call_chain_is_empty(9)
• blocking_notifier_chain_register(9)
• blocking_notifier_chain_register_unique_prio(9)
• blocking_notifier_chain_unregister(9)
• blocking_notifier_call_chain(9)
• raw_notifier_chain_register(9)
• raw_notifier_chain_unregister(9)
• raw_notifier_call_chain(9)
• srcu_notifier_chain_register(9)
• srcu_notifier_chain_unregister(9)
• srcu_notifier_call_chain(9)
• srcu_init_notifier_head(9)

Later, bestie 🫶 — source/version: ./kernel, date: October 2026, page: atomic_notifier_call_chain(9). Mwah 💋