ssam_notifie...e_registered(9)

✨ ssam_notifier_restore_registered 💅

okay bestie, so this is a page from the Kernel API Manual, section (9) — yes, the big scary kernel one, but we're gonna get through it together 🫶

---

🌸 NAME 🌸

ssam_notifier_restore_registered — the glow-up function that restores / re-enables events for all registered notifiers. it's giving "everybody back in the group chat" energy 💖

---

🎀 SYNOPSIS 🎀

void ssam_notifier_restore_registered (struct ssam_controller *ctrl );

like, that's the whole signature. one argument, returns nothing, no cap ✨

---

🦋 ARGUMENTS 🦋

• ctrl — the controller whose notifiers/events we're restoring. this is the main character of the whole operation, fr fr 👑

---

💜 DESCRIPTION 💜

so what it actually does: it restores / re-enables every event that has a notifier registered on the given controller. all of them. group by group. the whole roster 🌈

⚠️ real talk: if something fails, it does not bail out. the error gets logged, and the function keeps going and tries to enable the remaining events anyway 😭 iconic resilience, honestly.

the intended use case is restoring / re-enabling all registered events after hibernation — like when your laptop wakes up and everyone needs to be re-added to the chat 🧚✨

and if you wanna see the mirror-image move — the counterpart that disables the events, plus more details — go look at ssam_notifier_disable_registered. besties who do opposite things 💅

---

⭐ SEE ALSO ⭐

the kernel file in question, first of all:

• ./drivers/platform/surface/aggregator/controller.c

and now the entire friend group, no one left out, i promised 🫶:

• ssh_seq_reset(9)
• ssh_seq_next(9)
• ssh_rqid_reset(9)
• ssh_rqid_next(9)
• ssam_event_matches_notifier(9)
• ssam_nfblk_call_chain(9)
• ssam_nfblk_insert(9)
• ssam_nfblk_find(9)
• ssam_nfblk_remove(9)
• ssam_nf_head_init(9)
• ssam_nf_head_destroy(9)
• struct ssam_nf_refcount_key(9)
• struct ssam_nf_refcount_entry(9)
• ssam_nf_refcount_inc(9)
• ssam_nf_refcount_dec(9)
• ssam_nf_refcount_dec_free(9)
• ssam_nf_refcount_empty(9)
• ssam_nf_call(9)
• ssam_nf_init(9)
• ssam_nf_destroy(9)
• ssam_event_item_cache_init(9)
• ssam_event_item_cache_destroy(9)
• ssam_event_item_free(9)
• ssam_event_item_alloc(9)
• ssam_event_queue_push(9)
• ssam_event_queue_pop(9)
• ssam_event_queue_is_empty(9)
• ssam_cplt_get_event_queue(9)
• ssam_cplt_submit(9)
• ssam_cplt_submit_event(9)
• ssam_cplt_flush(9)
• ssam_event_queue_init(9)
• ssam_cplt_init(9)
• ssam_cplt_destroy(9)
• ssam_controller_device(9)
• ssam_controller_get(9)
• ssam_controller_put(9)
• ssam_controller_statelock(9)
• ssam_controller_stateunlock(9)
• ssam_controller_lock(9)
• ssam_controller_caps_load_from_acpi(9)
• ssam_controller_caps_load_from_of(9)
• ssam_controller_caps_load(9)
• ssam_controller_init(9)
• ssam_controller_start(9)
• ssam_controller_shutdown(9)
• ssam_controller_destroy(9)
• ssam_controller_suspend(9)
• ssam_controller_resume(9)
• ssam_request_write_data(9)
• ssam_request_sync_alloc(9)
• ssam_request_sync_free(9)
• ssam_request_sync_init(9)
• ssam_request_sync_submit(9)
• ssam_request_do_sync(9)
• ssam_request_do_sync_with_buffer(9)
• struct ssh_notification_params(9)
• ssam_ssh_event_enable(9)
• ssam_ssh_event_disable(9)
• ssam_get_firmware_version(9)
• ssam_ctrl_notif_display_off(9)
• ssam_ctrl_notif_display_on(9)
• ssam_ctrl_notif_d0_exit(9)
• ssam_ctrl_notif_d0_entry(9)
• ssam_nf_refcount_enable(9)
• ssam_nf_refcount_disable_free(9)
• ssam_notifier_register(9)
• __ssam_notifier_unregister(9)
• ssam_controller_event_enable(9)
• ssam_controller_event_disable(9)
• ssam_notifier_disable_registered(9)
• ssam_notifier_is_empty(9)
• ssam_notifier_unregister_all(9)
• ssam_irq_setup(9)
• ssam_irq_free(9)
• ssam_irq_arm_for_wakeup(9)
• ssam_irq_disarm_wakeup(9)

like… that's the whole friend list. every single one made it to the party 🎉💀

---

okay that's the page!! 🦋 this lil beauty lives in ./drivers/platform/surface/agg... (yes, the abbreviated lil path, she's shy) and it's stamped October 2026 — future icon behaviour honestly 👑✨ love that for her. mwah, go restore those notifiers bestie 💖🎀