ENUM SSAM_REQUEST_FLAGS(9)

✨ enum ssam_request_flags — Flags for SAM requests ✨

okay bestie, so this is a page from the Kernel API Manual, and it's literally just a little enum that holds the vibe-check rules for SAM requests 💅 like, it's short, but it's important, so pay attention 🫶

🌸 SYNOPSIS 🌸

enum ssam_request_flags {
    SSAM_REQUEST_HAS_RESPONSE ,
    SSAM_REQUEST_UNSEQUENCED

};

no cap, that's the whole thing. two flags. two little switches that change how a request gets sent. iconic behavior honestly 🎀

🌈 Constants 🌈

• SSAM_REQUEST_HAS_RESPONSE — this one's saying "bestie, i expect a reply 💌". if it's not set, the request gets directly completed right after its underlying packet has been transmitted — like, done, bye, no waiting around. but if it is set, the request transport system waits for a response to the request. it's giving "read receipt on" energy 👀
• SSAM_REQUEST_UNSEQUENCED — this one means the request should be transmitted via an unsequenced packet ⚡ and here's the tea: if this is set, the request must not have a response. so this flag and the SSAM_REQUEST_HAS_RESPONSE flag are mutually exclusive — pick one, you cannot have both, that's the rules fr fr 🙈

ok so quick recap because i love you: HAS_RESPONSE = "i want a reply", UNSEQUENCED = "sent unsequenced, and therefore absolutely no reply allowed". they do NOT coexist. periodt 💀

🦋 SEE ALSO 🦋

• Kernel file ./include/linux/surface_aggregator/controller.h
• enum ssam_event_flags(9)
• struct ssam_event(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)
• 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 — a LOT of friends. go read them, they're all slay, i promise 🧚‍♀️

aaaand that's the page!! shipped from ./include/linux/surface_aggregator/controller.h, stamped October 2026, living in the Kernel API Manual 💖 mwah, go write some kernel code bestie, you got this ⭐👑