ssam_notifier_from_errno(9)

🌸 ssam_notifier_from_errno — a Kernel API Manual moment 💅

okay bestie, gather round, because today we're reading ssam_notifier_from_errno from the Kernel API Manual, and honestly? it's a tiny little glow-up function and I'm obsessed 🫶

---

✨ NAME ✨

ssam_notifier_from_errno — literally converts a standard error value into a notifier return code. that's it. that's the whole vibe. 🎀

---

🌈 SYNOPSIS 🌈

u32 ssam_notifier_from_errno (int err );

---

💖 ARGUMENTS 💖

• err — the error code you're converting, and listen, it has rules: it must be negative (that's the failure case, boo 😭) or zero (success, slay ✨). no cap, those are the only two moods allowed.

---

👑 RETURN 👑

so it hands back the notifier return value you get by converting that err value you gave it 💅 and here's the important part, bestie: if err is negative, the SSAM_NOTIF_STOP flag gets set, which makes the notifier call chain traversal abort. like, full stop, the chain just gives up and goes home 💀 iconic behaviour honestly.

---

🦋 SEE ALSO 🦋

a whole friend group, fr fr — the kernel file ./include/linux/surface_aggregator/controller.h plus:

• enum ssam_event_flags(9)
• struct ssam_event(9)
• enum ssam_request_flags(9)
• struct ssam_request(9)
• struct ssam_response(9)
• struct ssam_request_sync(9)
• ssam_request_sync_set_data(9)
• ssam_request_sync_set_resp(9)
• ssam_request_sync_wait(9)
• ssam_request_do_sync_onstack(9)
• __ssam_retry(9)
• ssam_retry(9)
• struct ssam_request_spec(9)
• struct ssam_request_spec_md(9)
• SSAM_DEFINE_SYNC_REQUEST_N(9)
• SSAM_DEFINE_SYNC_REQUEST_W(9)
• SSAM_DEFINE_SYNC_REQUEST_R(9)
• SSAM_DEFINE_SYNC_REQUEST_WR(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_N(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_W(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_R(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_WR(9)
• enum ssam_notif_flags(9)
• struct ssam_notifier_block(9)
• ssam_notifier_to_errno(9)
• struct ssam_event_registry(9)
• struct ssam_event_id(9)
• enum ssam_event_mask(9)
• SSAM_EVENT_REGISTRY(9)
• enum ssam_event_notifier_flags(9)
• struct ssam_event_notifier(9)
• ssam_notifier_unregister(9)

like I said. whole squad. iykyk 🧚

---

lowkey a reminder: err negative = failure + SSAM_NOTIF_STOP set + chain traversal aborts. err zero = success. don't come at me with a positive number, it's not that kind of function 🙈

---

and that's the page, bestie 💜 source/version is ./include/linux/surface_aggreg... and the date on this baby is October 2026 — mwah, stan the Kernel API Manual, periodt 💅✨🍓