__ssam_notifier_unregister(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 __ssam_notifier_unregister(9) — Kernel API Manual 🌸

okay bestie, welcome to the Kernel API Manual page for __ssam_notifier_unregister(9) — the little cleanup queen that says "we're SO done here" to an event notifier. she's giving exit-interview energy and honestly? iconic. 💅

✨ NAME ✨

__ssam_notifier_unregister — Unregister an event notifier. that's it, that's the whole job. 🎀

🌈 SYNOPSIS 🌈

int __ssam_notifier_unregister (struct ssam_controller *ctrl , struct
       ssam_event_notifier *n , bool disable );

look at her. three params, one int back, no drama (most of the time 👀).

💖 ARGUMENTS 💖

  • ctrl — The controller the notifier has been registered on. like, the specific one, don't just hand her any controller, she needs the one. 🫶
  • n — The event notifier to unregister. the main character of this whole operation fr.
  • disable — Whether to disable the corresponding event on the EC. true means yes go talk to the EC about it, false means absolutely not, do not. 💀

🦋 DESCRIPTION 🦋

so, unregister an event notifier. simple, right? mostly! here's the tea tho:

Decrement the usage counter of the associated SAM event if the notifier is not marked as an observer. then — and this is the part you gotta pay attention to — if the usage counter reaches zero and disable equals true, the event will be disabled.

ngl the disable flag is the whole vibe check here, so let's talk about why it exists. 🙈

This function is useful for hot-removable devices, where communication may fail once the device has been physically removed. in that case, specifying disable as false avoids communication with the EC. like, don't yell at the hardware that isn't there anymore bestie, that's just rude and also it won't answer. 😭

⭐ RETURN ⭐

  • Returns zero on success — slay. ✨
  • -ENOENT if the given notifier block has not been registered on the controller. (translation: you can't unregister something that was never registered, go home.) 💀
  • If the given notifier block was the last one associated with its specific event, returns the status of the event-disable EC-command. so basically you're also getting the receipts from that EC call, no pressure. 🔥

👑 SEE ALSO 👑

Kernel file ./drivers/platform/surface/aggregator/controller.c

and now the extended universe, hold on to your iced coffee:

like I said. whole extended universe. iykyk 🧚

and that's the page!! mwah 💋 this cutie came from ./drivers/platform/surface/agg... and she's stamped October 2026 — go unregister responsibly, bestie, and remember: if the counter hits zero and disable is true, the event gets disabled. no cap. 🍓

📦 where this page comes from