ssam_device...ier_register(9)

💅 ssam_device_notifier_register(9) 💅

okay bestie, welcome to the Kernel API Manual entry for ssam_device_notifier_register — yes, the name is a whole mouthful, but we're here, we're hydrated, and we're slaying. 💖

💖 NAME 💖

ssam_device_notifier_register — register an event notifier for the specified client device, periodt. ✨

✨ SYNOPSIS ✨

int ssam_device_notifier_register (struct ssam_device *sdev , struct
ssam_event_notifier *n );

🫶 ARGUMENTS 🫶

• sdev — the device the notifier should be registered on. 🫶
• n — the event notifier to register. ✨

💅 DESCRIPTION 💅

okay so here's the tea: you're registering an event notifier. If that notifier is not marked as an observer, the usage counter of the associated SAM event gets incremented. 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, then 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. Slay. 🦋

🔥 RETURN 🔥

• Returns zero on success — we love a clean win. 🔥
• -ENOSPC if there have already been INT_MAX notifiers for the event ID/type associated with the notifier block registered. 😭
• -ENOMEM if the corresponding event entry could not be allocated. 💀
• -ENODEV if the device is marked as hot-removed. 🙈
• 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 🌈

first up, the kernel file in question is ./include/linux/surface_aggregator/device.h, and then the whole bestie directory:

• enum ssam_device_domain(9)
• enum ssam_virtual_tc(9)
• struct ssam_device_uid(9)
• SSAM_DEVICE(9)
• SSAM_VDEV(9)
• SSAM_SDEV(9)
• struct ssam_device(9)
• struct ssam_device_driver(9)
• is_ssam_device(9)
• to_ssam_device(9)
• to_ssam_device_driver(9)
• ssam_device_mark_hot_removed(9)
• ssam_device_is_hot_removed(9)
• ssam_device_get(9)
• ssam_device_put(9)
• ssam_device_get_drvdata(9)
• ssam_device_set_drvdata(9)
• ssam_device_driver_register(9)
• module_ssam_device_driver(9)
• ssam_register_clients(9)
• ssam_device_register_clients(9)
• SSAM_DEFINE_SYNC_REQUEST_CL_N(9)
• SSAM_DEFINE_SYNC_REQUEST_CL_W(9)
• SSAM_DEFINE_SYNC_REQUEST_CL_R(9)
• SSAM_DEFINE_SYNC_REQUEST_CL_WR(9)
• ssam_device_notifier_unregister(9)

xoxo, this page comes from ./include/linux/surface_aggreg... and is dated October 2026 — stay iconic, bestie 💅💖🎀