ssam_notifier_is_empty(9)

💖 ssam_notifier_is_empty(9) 💖

okay bestie, welcome to the ssam_notifier_is_empty page — it's a tiny one, a little snack of a kernel API function, but it's lowkey iconic. It lives in the ssam_notifier_is_empty(9) part of the Kernel API Manual and it does exactly one (1) thing: tells you whether the notifier list on a Surface Aggregator controller is empty or not. That's it. That's the whole vibe. 🦋

---

✨ NAME ✨

ssam_notifier_is_empty — check if there are any registered notifiers. yes, really, that's the whole job. she's a yes/no girlie. 💅

---

🌸 SYNOPSIS 🌸

bool ssam_notifier_is_empty (struct ssam_controller *ctrl );

literally just hand her a controller and she'll tell you if the notifier situation is empty or not. no cap. ✨

---

🎀 ARGUMENTS 🎀

• ctrl — the controller to check on. that's the one you're asking about, bestie, the controller whose notifier registry you want to peek at. 🫶

---

⭐ RETURN ⭐

Returns true if there are currently no notifiers registered on the controller, and false otherwise. so like — true = ghost town, nobody home, zero notifiers registered 👻; false = okay there's at least somebody in there, the list is not empty. simple as that, fr fr. 🔥

ngl it's giving "vibe check for an empty list" and honestly? we respect it. 😭

---

👑 SEE ALSO 👑

bestie there are a LOT of friends in this group chat, so buckle up. also the kernel file herself:

Kernel file ./drivers/platform/surface/aggregator/controller.c

the ssh sequence/rqid girlies 🧚

• ssh_seq_reset(9), ssh_seq_next(9), ssh_rqid_reset(9), ssh_rqid_next(9)

notifier block + matching 🔥

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

refcount era 💜

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

notifier core ✨

• ssam_nf_call(9), ssam_nf_init(9), ssam_nf_destroy(9)

event items 🍓

• ssam_event_item_cache_init(9), ssam_event_item_cache_destroy(9), ssam_event_item_free(9), ssam_event_item_alloc(9)

event queues 🌈

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

controller besties (the whole squad) 💖

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

requests 🎀

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

ssh event + firmware things 🦋

• struct ssh_notification_params(9), ssam_ssh_event_enable(9), ssam_ssh_event_disable(9), ssam_get_firmware_version(9)

ctrl notifications 🌸

• ssam_ctrl_notif_display_off(9), ssam_ctrl_notif_display_on(9), ssam_ctrl_notif_d0_exit(9), ssam_ctrl_notif_d0_entry(9)

refcount enable/disable + notifier register/unregister 💀

• ssam_nf_refcount_enable(9), ssam_nf_refcount_disable_free(9), ssam_notifier_register(9), __ssam_notifier_unregister(9)

controller event enable/disable + the notifier restoration crew 🙈

• ssam_controller_event_enable(9), ssam_controller_event_disable(9), ssam_notifier_disable_registered(9), ssam_notifier_restore_registered(9), ssam_notifier_unregister_all(9)

irq squad ⭐

• ssam_irq_setup(9), ssam_irq_free(9), ssam_irq_arm_for_wakeup(9), ssam_irq_disarm_wakeup(9)

---

and that's the whole page, bestie!! 🫶 ok bye, go check your notifiers, mwah 💋

— source/version: ./drivers/platform/surface/agg... 🌈 dated October 2026 ⭐ ssam_notifier_is_empty(9) 💅