ssam_request...sync_onstack(9)

🌸 NAME 🌸

okay so bestie, you're in the Kernel API Manual, and this page is ssam_request...sync_onstack(9). The actual star of the show is ssam_request_do_sync_onstack — Execute a synchronous request on the stack. Slay. 💅

---

✨ SYNOPSIS ✨

ssam_request_do_sync_onstack (ctrl , rqst , rsp , payload_len );

---

🎀 ARGUMENTS 🎀

• ctrl — the controller that the request gets submitted through.
• rqst — the request specification.
• rsp — the response buffer.
• payload_len — the (maximum) request payload length.

---

🦋 DESCRIPTION 🦋

So here's the vibe: this helper allocates a synchronous request with the specified payload length on the stack, fully initializes it via the provided request specification, submits it, and then finally waits for its completion before returning its status. Main character energy fr fr.

Essentially, this helper macro allocates the request message buffer on the stack and then calls ssam_request_do_sync_with_buffer. That's the whole glow-up. ✨

---

💀 NOTE 💀

The payload_len parameter specifies the maximum payload length, used for buffer allocation. The actual payload length may be smaller. So don't get it twisted: max length ≠ actual length, iykyk. 🙈

---

👑 RETURN 👑

Returns the status of the request or any failure during setup, i.e. zero on success and a negative value on failure. 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_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)

---

Cute sign-off time: brought to you by ./include/linux/surface_aggreg... · October 2026 · page ssam_request...sync_onstack(9) 💅✨🫶