ssam_cplt_flush(9)

🌸 NAME 🌸

Okay so welcome to ssam_cplt_flush(9) from the Kernel API Manual, bestie! This page is literally about ssam_cplt_flush — the function that flushes the completion system. It's giving cleanup main character energy, and we're obsessed. 💖

---

✨ SYNOPSIS ✨

void ssam_cplt_flush (struct ssam_cplt *cplt );

---

🫶 ARGUMENTS 🫶

• cplt — the completion system. That's the one and only argument, and yes she is highkey the main character here. 👑

---

💅 DESCRIPTION 💅

Flush the completion system by waiting until all currently submitted work items have been completed. That's the whole vibe: wait for the submitted work items to finish, no cap. Fr fr, that's the description. Periodt. ✨

---

😭 NOTE 😭

Okay bestie, important vibe check: not me expecting a full guarantee — because this function does not guarantee that all events will have been handled once this call terminates. Ngl, in case of a larger number of to-be-completed events, the event queue work function may re-schedule its work item, which this flush operation will ignore. 🙈

This operation is only intended to, during normal operation prior to shutdown, try to complete most events and requests to get them out of the system while the system is still fully operational. It does not aim to provide any guarantee that all of them have been handled. So like, it's a "try to get most of them out" moment, not a magical "everything is done" button. 💀

---

👑 SEE ALSO 👑

The kernel file is literally right here: ./drivers/platform/surface/aggregator/controller.c — go peek, iykyk. 🦋

And here's the whole SEE ALSO squad, every single one, no cap — it's iconic 🔥:

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

Signed off with source/version ./drivers/platform/surface/agg... and date October 2026 — stay slay, bestie, and may your completion system flush cleanly. 💖✨🎀💅