scmi_register_event_handler(9)

✨ scmi_register_event_handler(9) ✨

Okay bestie, welcome to the Kernel API Manual corner of the group chat 🫶 This is the page for scmi_register_event_handler(9), and yes, it’s giving “tiny function, important job” energy.

🌸 NAME 🌸

scmi_register_event_handler — Register whenever possible an Event handler. Periodt.

🦋 SYNOPSIS 🦋

int scmi_register_event_handler (struct scmi_notify_instance *ni ,
       struct scmi_event_handler *hndl );

💅 ARGUMENTS 💅

• ni — A reference to the notification instance to use.
• hndl — The event handler to register.

🎀 DESCRIPTION 🎀

First, this function tries to bind an event handler to its associated event. Then it checks if it was at least a valid pending handler: if it was not bound nor valid, it returns false. That’s the whole vibe check, no cap.

Valid pending incomplete bindings get periodically retried by a dedicated worker, and that worker gets kicked each time a new protocol completes its own registration phase. Lowkey a little cleanup crew, but make it kernel. 🧚

🔥 CONTEXT 🔥

Assumes to be called with pending_mtx acquired. Do not skip that part, bestie — this page literally assumes it, fr fr. 🔒

🌈 RETURN 🌈

0 on Success. That’s the good ending. 💖

👑 SEE ALSO 👑

• 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_event_handler_get_ops(9)
• scmi_get_active_handler(9)
• __scmi_enable_evt(9)
• scmi_put_handler_unlocked(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)

---

That’s the whole page, bestie 🎀 Source/version: ./drivers/firmware/arm_scmi · date: October 2026 · page: scmi_register_event_handler(9). Okay bye, go register that handler responsibly 💜