scmi_allocat..._events_desc(9)

🌸 NAME 🌸

scmi_allocate_registered_events_desc — allocate a registered events' descriptor, bestie 🎀

Hey bestie 💖 welcome to scmi_allocat..._events_desc(9) from the Kernel API Manual. This page is all about allocating a registered events' descriptor, and we're gonna keep every detail cute but correct. No cap. ✨

✨ SYNOPSIS ✨

The whole signature, untouched:

struct scmi_registered_events_desc *
scmi_allocate_registered_events_desc (struct scmi_notify_instance *ni ,
u8 proto_id , size_t queue_sz , size_t eh_sz , int num_events , const
struct scmi_event_ops *ops );

🎀 ARGUMENTS 🎀

• ni — A reference to the struct scmi_notify_instance notification instance to use 🫶
• proto_id — Protocol ID 🏷️
• queue_sz — Size of the associated queue to allocate 📦
• eh_sz — Size of the event header scratch area to pre-allocate 🧠
• num_events — Number of events to support (size of registered_events) 🔢
• ops — Pointer to a struct holding references to protocol specific helpers needed during events handling 🛠️

💅 DESCRIPTION 💅

This one is supposed to be called only once for each protocol, at protocol initialization time. So if the requested protocol is found already registered, it warns. ⚠️

🔥 RETURN 🔥

On Success, you get the allocated and registered descriptor back. ✅

🦋 SEE ALSO 🦋

Go read these too, bestie:

• 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_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_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)

mwah 💋 — this page is from ./drivers/firmware/arm_scmi, dated October 2026, and it's the scmi_allocat..._events_desc(9) manual. 💖