STRUCT SSAM_REQUEST_SYNC(9)

🌸 NAME 🌸

Hii bestie 💖, welcome to the struct ssam_request_sync(9) page from the Kernel API Manual! This is all about struct ssam_request_sync — the Synchronous SAM request struct. That's the name, that's the vibe, and yes, it's giving kernel-API main character energy 👑.

✨ SYNOPSIS ✨

       struct ssam_request_sync {
           struct ssh_request base;
           struct completion comp;
           struct ssam_response *resp;
           int status;
        };

🫶 Members 🫶

Okay so here's the member squad, bestie — every one of them matters, no skipping:

• base — the underlying SSH request. Lowkey the foundation of the whole thing.
• comp — completion used to signal full completion of the request. After the request has been submitted, this struct may only be modified or deallocated after the completion has been signaled. Also, the original text has a lil' dangling "request has been submitted," at the end — not me making stuff up, it's literally there 🙈 keeping every detail, periodt.
• resp — buffer to store the response. Your response-holding bestie.
• status — status of the request, set after the base request has been completed or has failed. The receipts after the base request finishes or flops, fr fr.

💅 SEE ALSO 💅

The kernel file to know is ./include/linux/surface_aggregator/controller.h, and here's the whole friend group pulling up:

• enum ssam_event_flags(9)
• struct ssam_event(9)
• enum ssam_request_flags(9)
• struct ssam_request(9)
• struct ssam_response(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)

mwah 💋 — that's the page, bestie! Cute lil' sign-off from ./include/linux/surface_aggreg..., dated October 2026, and it's all the struct ssam_request_sync(9) content from the Kernel API Manual. 🎀