STRUCT SCMI_NOTIFY_INSTANCE(9)

💖 struct scmi_notify_instance(9) 💖

okay so bestie, this is the Kernel API Manual page for struct scmi_notify_instance(9), and it’s giving “one notification-core instance per platform handle” energy. Let’s get into it 💅

---

🌸 NAME 🌸

struct scmi_notify_instance — represents an instance of the notification core. That’s literally the whole name, and it ate.

---

✨ SYNOPSIS ✨

Here’s the exact struct, no cap — keep it character-for-character if you’re doing kernel things:

       struct scmi_notify_instance {
           void *gid;
           struct scmi_handle      *handle;
           struct work_struct      init_work;
           struct workqueue_struct *notify_wq;
           struct mutex            pending_mtx;
           unsigned long pending_events_handlers[1 << (( SCMI_PENDING_HASH_SZ)
       - 1)];
           struct scmi_registered_events_desc
       *registered_protocols[SCMI_MAX_PROTO];
        };

---

💅 Members 💅

Member-by-member vibe check, bestie ✨

• gid — the GroupID used for devres 🫶
• handle — a reference to the platform instance 🔥
• init_work — a work item to perform final initializations of pending handlers 🌸
• notify_wq — a reference to the allocated Kernel cmwq 💀
• pending_mtx — a mutex to protect pending_events_handlers 🔒
• pending_events_handlers — an hashtable containing all pending events’ handlers descriptors 👑
• registered_protocols — a statically allocated array containing pointers to all the registered protocol-level specific information related to events’ handling 🌈

---

🌟 Description 🌟

Each platform instance — the one represented by a handle — has its own instance of the notification subsystem, and this structure is literally that instance. Main character energy for every platform handle, fr fr 💖

---

🎀 SEE ALSO 🎀

Go read these too, bestie — the whole friend group:

• Kernel file ./drivers/firmware/arm_scmi/notify.c
• Theory of operation(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_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)

---

💌 sign-off time: source/version ./drivers/firmware/arm_scmi, date October 2026, page struct scmi_notify_instance(9) — bye bestie 🫶