STRUCT SSAM_REQUEST_SPEC(9)

💅 struct ssam_request_spec(9) — a Kernel API Manual moment ✨

okay bestie, listen up, because this one is literally the blue-print for a SAM request and it's giving "template energy" in the best way 🫶

---

✨ NAME ✨

struct ssam_request_spec — the Blue-print specification of a SAM request. yes, with a capital B and a hyphen, that's how the kernel rolls 💅

---

🌸 SYNOPSIS 🌸

struct ssam_request_spec {
    u8 target_category;
    u8 target_id;
    u8 command_id;
    u8 instance_id;
    u8 flags;
 };

ngl this struct is tiny but she is important, so let's meet the members one by one 🎀

---

🦋 Members 🦋

• target_category — the Category of the request's target. peep enum ssam_ssh_tc for the deets ✨
• target_id — the ID of the request's target, straightforward icon behavior 👑
• command_id — the Command ID of the request. that's her whole thing 💜
• instance_id — the Instance ID of the request's target. yes it's separate from target_id, don't come for me 🙈
• flags — the Flags for the request. go look at enum ssam_request_flags for the full menu 🍓

---

💖 Description 💖

so Blue-print specification for a SAM request. this struct describes the unique static parameters of a request (i.e. its type) without specifying any of its instance-specific data (e.g. the payload). think of it as the vibe check of the request, not the whole personality 😌

it's literally intended to be used as the base for defining simple request functions via the SSAM_DEFINE_SYNC_REQUEST_x family of macros. that's the whole point, that's the assignment, periodt 🔥

---

🌈 SEE ALSO 🌈

• 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_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)

yeah that's a lot of cross-refs, but she's connected, iykyk 💀 go read them, they're all iconic in their own right 🧚

---

k bye bestie, this page came from ./include/linux/surface_aggreg... and it's dated October 2026 — mwah, slay, go write some sync requests 💅💖⭐