ssam_notifie...e_registered(9)
π ssam_notifier_disable_registered β Kernel API Manual, section 9 β¨
okay so bestie, welcome to the kernel side of the group chat π«Ά this is a page from the Kernel API Manual, section 9, and it's all about shutting off a whole bunch of events at once so your laptop can go night-night. let's get into it π
β¨ NAME β¨
ssam_notifier_disable_registered β literally disables events for all the registered notifiers. that's it, that's the whole vibe. π
π SYNOPSIS π
int ssam_notifier_disable_registered (struct ssam_controller *ctrl );
πΈ ARGUMENTS πΈ
ctrlβ the controller you want to turn the notifiers/events off for. like, hand her the controller and she'll handle the rest π«Ά
π¦ DESCRIPTION π¦
so what she does is: she disables events for all the notifiers that are currently registered. β
but listen β if something goes wrong (the EC command fails), she's not gonna leave you hanging. all the events she already disabled get restored, and then she returns that error code right back atcha. no half-finished mess, we don't do that here ππ
this function was literally made to disable all the events before hibernation entry. and when you're ready to bring everything back to life, hit up ssam_notifier_restore_registered β she restores/re-enables every event that got disabled by this function. the duo of the century, no cap π
ok important caveat bestie: this function will not disable events for notifiers that get registered after you call it. so you gotta make absolutely sure that no new notifiers are gonna be added after this call and before the corresponding call to ssam_notifier_restore_registered. periodt. don't test her π
π RETURN π
- returns zero on success β yes queen, we love a clean
0β¨ - on failure, it returns the error code returned by the failed EC command to disable an event. so if you see a weird number, that's the culprit π΅οΈββοΈ
π§ SEE ALSO π§
the whole squad and the kernel file they live in:
- kernel file
./drivers/platform/surface/aggregator/controller.c 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_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 that's the page, bestie β¨ this icon came from ./drivers/platform/surface/agg... and it's dated October 2026 β so go forth, disable those events responsibly, and remember: no new notifiers between the disable and the restore. iykyk πππ¦πΈπ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms