ENUM SSAM_EVENT_MASK(9)

💅 NAME 💅

enum ssam_event_mask — the little flag squad that tells the kernel how to match events to notifiers. And yes bestie, we're in the Kernel API Manual today, buckle up 🎀

✨ SYNOPSIS ✨

enum ssam_event_mask {
    SSAM_EVENT_MASK_TARGET ,
    SSAM_EVENT_MASK_INSTANCE ,
    SSAM_EVENT_MASK_NONE ,
    SSAM_EVENT_MASK_STRICT

};

🌸 Constants 🌸

okay so these are the four mood boards an event mask can serve 💅

• SSAM_EVENT_MASK_TARGET — so on top of filtering by target category, it also only runs the notifier callback for events whose target ID matches the one of the registry you used to enable/disable the event. picky, but in a cute way 🎯
• SSAM_EVENT_MASK_INSTANCE — same deal, but instead of the registry: on top of filtering by target category, it only runs the notifier callback for events with an instance ID matching the instance ID you used when enabling the event. matching fits, periodt 💫
• SSAM_EVENT_MASK_NONE — no extra rules, no extra vibes: run the callback for any event with a matching target category. Do not do any additional filtering. it's giving chill ✌️
• SSAM_EVENT_MASK_STRICT — do all the filtering above. all of it. every single layer. highkey the maximalist option 👑

🦋 SEE ALSO 🦋

so you can keep the whole friend group together, these all live in the kernel file ./include/linux/surface_aggregator/controller.h too 🫶

• 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_registry(9)
• struct ssam_event_id(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 crumbs left 💖 this one came from ./include/linux/surface_aggreg... and it's dated October 2026 — go off, calendar icon 🗓️✨ ily, study hard, and remember: strict mode is a lifestyle 👑💅