scmi_put_handler_unlocked(9)

💅 scmi_put_handler_unlocked(9) — like, the kernel API manual, bestie ✨

okay so first things first, the manual name is scmi_put_handler_unlocked(9) and no we are not skipping that, it's literally the whole point of this page 🎀 this is a kernel API manual and it's about putting an event handler — yes that's the NAME, and yes "put" here means putting it down, not putting it on, stay with me 🫶

---

✨ SYNOPSIS ✨

bool scmi_put_handler_unlocked (struct scmi_notify_instance *ni , struct
       scmi_event_handler *hndl );

like look at her 👑 returns a bool, takes two things, that's the whole vibe check.

---

🌸 ARGUMENTS 🌸

• ni — a reference to the notification instance you wanna use, like your little handle on the notification world 🦋
• hndl — the event handler you're acting upon, bestie, this is the one getting the treatment 💅

---

💖 DESCRIPTION 💖

okay so picture this: you've already got exclusive access to the registered handlers hashtable 👏 — that's on you, not on this function — and now you update the refcount. and then, if hndl is no more in use by anyone (like, zero girlies holding it), you:

• ask for events' generation disabling 🔥
• unregister and free the handler itself 💀

not me doing cleanup arc, but honestly? iconic. this is the function that closes the tab when the last person leaves the group chat 🫶

---

🧚 CONTEXT 🧚

she assumes all the proper locking has been managed by the caller. that's you. yes, you. no cap, this function is not doing the locking for you, so don't come for her when it goes sideways 🙈

fr fr, read that again: the caller handles the locking. this is _unlocked, it's in the name, iykyk 💅

---

⭐ RETURN ⭐

Returns true if the handler was freed (meaning users dropped to zero) 🎉 otherwise not, and that's your answer, periodt.

---

🌈 SEE ALSO 🌈

the whole friend group, honestly. go say hi:

• Kernel file ./drivers/firmware/arm_scmi/notify.c
• Theory of operation(9)
• struct scmi_notify_instance(9)
• struct events_queue(9)
• struct scmi_event_header(9)
• struct scmi_registered_events_desc(9)
• struct scmi_registered_event(9)
• struct scmi_event_handler(9)
• scmi_lookup_and_call_event_chain(9)
• scmi_process_event_header(9)
• scmi_process_event_payload(9)
• scmi_events_dispatcher(9)
• scmi_notify(9)
• scmi_kfifo_free(9)
• scmi_initialize_events_queue(9)
• scmi_allocate_registered_events_desc(9)
• scmi_register_protocol_events(9)
• scmi_deregister_protocol_events(9)
• scmi_allocate_event_handler(9)
• scmi_free_event_handler(9)
• scmi_bind_event_handler(9)
• scmi_valid_pending_handler(9)
• scmi_register_event_handler(9)
• __scmi_event_handler_get_ops(9)
• scmi_get_active_handler(9)
• __scmi_enable_evt(9)
• scmi_event_handler_enable_events(9)
• scmi_notifier_register(9)
• scmi_notifier_unregister(9)
• scmi_devm_notifier_register(9)
• scmi_devm_notifier_unregister(9)
• scmi_protocols_late_init(9)
• scmi_notification_init(9)
• scmi_notification_quiesce(9)
• scmi_notification_exit(9)

---

and that's the page, bestie!! 🎀 this lil beauty lives at ./drivers/firmware/arm_scmi and she's dated October 2026 — yes, 2026, she's booked and busy 💜 mwah, go free some handlers, ily 🫶✨