STRUCT SSAM_EVENT_REGISTRY(9)

💅 struct ssam_event_registry(9) ✨

okay so bestie, welcome to the Kernel API Manual (yes, that Kernel API Manual, the 9th section, we're fancy here 🎀). Today's main character is struct ssam_event_registry — the lil' registry specification used for enabling events. she's small, she's specific, she's iconic. let's get into it 💖

---

✨ SYNOPSIS ✨

struct ssam_event_registry {
    u8 target_category;
    u8 target_id;
    u8 cid_enable;
    u8 cid_disable;
 };

like, four fields, all u8, no notes. minimalism ate. 🦋

---

🌸 Members 🌸

• target_category — the target category for the event registry requests. yes bestie, category. that's her whole job 💅
• target_id — the target ID for the event registry requests. the ID to the category's category, if you will 👑
• cid_enable — the command ID for the event-enable request 🔥
• cid_disable — the command ID for the event-disable request 💀

---

💖 Description 💖

so this struct describes a SAM event registry via the most minimal collection of SAM IDs possible — literally just the set of IDs that specify which requests to use for enabling and disabling an event. nothing extra, no bloat, she's lowkey efficient like that 🌈

and the important plot twist: the individual event that's actually being enabled or disabled is not described here, nope. that one's specified via struct ssam_event_id instead. so this struct is the how, and struct ssam_event_id is the which. iykyk 🫶

---

🦋 SEE ALSO 🦋

fr fr go read these too, they're all part of the same friend group:

• Kernel file ./include/linux/surface_aggregator/controller.h
• 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_from_errno(9)
• ssam_notifier_to_errno(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)

---

that's the whole page, no cap 💜 this little writeup lives in ./include/linux/surface_aggreg… (the path got cut off mid-vibe, we don't gatekeep), and it's dated October 2026 — so yeah, she's from the future, main character energy fr. periodt. 💅✨🎀