ssam_controller_resume(9)

💖 ssam_controller_resume — a.k.a. the Kernel API Manual page, bestie edition ✨

okay so this whole thing lives in your kernel API manual, and today's main character is ssam_controller_resume. yes, that's a function name AND the page name. slay. let's get into it 🫶

---

✨ NAME ✨

ssam_controller_resume — wakes the controller back up from suspend. that's it. that's the vibe check. 💅

---

🌸 SYNOPSIS 🌸

int ssam_controller_resume (struct ssam_controller *ctrl );

like, one argument. one return. we keep it cute and minimal, no cap. ✨

---

🎀 ARGUMENTS 🎀

• ctrl — the controller you're waking up. the one. the main character of this call. 🦋

---

💜 DESCRIPTION 💜

so here's the tea ☕ — this function resumes the controller from the suspended state that it got put into via ssam_controller_suspend. that's literally the whole job.

⚠️ but listen, bestie, because this part matters: this function does not issue display-on and D0-entry notifications. nope. not doing it. if you need those, you have to send them manually after this call. it's giving "i did my part, you handle the rest." 💀

---

🌈 RETURN 🌈

returns -EINVAL if the controller is currently not suspended. like, it can't resume something that isn't asleep, babes. know the difference. 😭

---

🧚 SEE ALSO 🧚

okay this list is LONG long, so buckle up, we're going on a journey through the whole drivers/platform/surface/aggregator cinematic universe. the kernel file itself lives at ./drivers/platform/surface/aggregator/controller.c — go say hi. 👑

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

and if that wasn't enough reading material for you, the source path gets the dramatic truncation treatment in the footer as ./drivers/platform/surface/agg.... iconic. 🍓

---

that's the page, bestie!! 💅 this little beauty came out of the kernel API manual — source/version vibes straight from ./drivers/platform/surface/agg..., dated October 2026, and yes, it's filed under ssam_controller_resume(9). go forth and resume responsibly, and don't forget your display-on and D0-entry notifications, because the function is literally not gonna do it for you 😭🫶✨