STRUCT SSAM_REQUEST(9)

💖 struct ssam_request(9) 💖

okay so bestie, welcome to the Kernel API Manual — this is the page for struct ssam_request, and it's literally the blueprint babe. it's giving "form you fill out before the actual message gets sent" energy. let's go 🫶

---

✨ NAME ✨

struct ssam_request — the SAM request description. that's it, that's the name, and honestly? iconic.

---

🦋 SYNOPSIS 🦋

here's the whole struct, bestie, no cap, every field exactly as it is:

struct ssam_request {
    u8 target_category;
    u8 target_id;
    u8 command_id;
    u8 instance_id;
    u16 flags;
    u16 length;
    const u8 *payload;
 };

look at her. seven fields. perfect posture. main character energy 👑

---

🎀 Members 🎀

okay so now the vibe check on every single one of these, one by one, because we do NOT skip:

• target_category — the category of the request's target. for more deets, see enum ssam_ssh_tc. like, the neighbourhood the target lives in 💅
• target_id — the ID of the request's target. hi bestie, which one are you 👋
• command_id — the command ID of the request. what are we even asking for, fr fr
• instance_id — the instance ID of the request's target. the specific lil instance, yk?
• flags — flags for the request. see enum ssam_request_flags for the whole menu ✨
• length — length of the request payload, in bytes. count 'em, don't guess 🍓
• payload — the request payload data. the actual snack inside the wrapper 🎁

---

🌸 Description 🌸

so this struct fully describes a SAM request with payload. like, completely. the whole thing. no crumbs left.

her whole purpose in life is to help you set up the actual transport struct — for example struct ssam_request_sync — and specifically its raw message data, via ssam_request_write_data. so think of ssam_request as the ✨concept✨ and the transport struct as the ✨delivery✨. she's the blueprint, not the building. iykyk 💜

---

🌈 SEE ALSO 🌈

buckle up bestie, this list is LONG and we are NOT cutting a single one, periodt:

• Kernel file ./include/linux/surface_aggregator/controller.h
• enum ssam_event_flags(9)
• struct ssam_event(9)
• enum ssam_request_flags(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. every. single. one. 💀 you're welcome.

---

quick vibe note: this whole page lives in ./include/linux/surface_aggregator/controller.h, and the footer says October 2026 — so yeah, she's dated, she's sourced, she's struct ssam_request(9) and she ate. no notes 🔥

okay bye bestie, go write some requests, ily, mwah 💋🎀🦋