ssam_notifier_register(9)

💖 NAME 💖

ssam_notifier_register - Register an event notifier.

okay so bestie, welcome to ssam_notifier_register(9) from the Kernel API Manual 💅✨

✨ SYNOPSIS ✨

int ssam_notifier_register (struct ssam_controller *ctrl , struct
       ssam_event_notifier *n );

🫶 ARGUMENTS 🫶

• ctrl — the controller to register the notifier on.
• n — the event notifier to register.

🌸 DESCRIPTION 🌸

okay so here’s the tea, bestie: this registers an event notifier. The usage counter of the associated SAM event gets incremented only if the notifier is not marked as an observer. If the event is not marked as an observer and is currently not enabled, it will be enabled during this call. If the notifier is marked as an observer, no attempt will be made at enabling any event and no reference count will be modified.

Notifiers marked as observers do not need to be associated with one specific event — i.e. as long as no event matching is performed, only the event target category needs to be set. 🦋

💀 RETURN 💀

• Returns zero on success.
• Returns -ENOSPC if there have already been INT_MAX notifiers for the event ID/type associated with the notifier block registered.
• Returns -ENOMEM if the corresponding event entry could not be allocated.
• If this is the first time that a notifier block is registered for the specific associated event, returns the status of the event-enable EC-command.

🌈 SEE ALSO 🌈

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

okay that’s the whole page bestie 💜 — footer check: source/version ./drivers/platform/surface/agg..., dated October 2026 🌸✨