ssam_request_sync_wait(9)

💅 ssam_request_sync_wait(9) 💅

okay so bestie, this is a page from the Kernel API Manual and it's all about ssam_request_sync_wait — the little function that makes you wait for your synchronous request to finish. yes, waiting. iconic behavior honestly 🌸

---

✨ SYNOPSIS ✨

int ssam_request_sync_wait (struct ssam_request_sync *rqst );

🎀 ARGUMENTS 🎀

• rqst — the request you're waiting on. that's it. that's the whole argument. she's simple, she's direct 🫶

---

💖 DESCRIPTION 💖

So here's the vibe: this function waits for a synchronous request to complete and be released. The way it works is, once this function terminates, the request is guaranteed to have left the transport system. like, she's out, she's gone, no cap ✨

And here's the rule you cannot skip, bestie — after a request has been successfully submitted, you must call this function before you do any of these:

• accessing the response of the request
• freeing the request
• freeing any of the buffers associated with the request

💀 HARD WARNING, FR FR: Do not call this function if the request has not been submitted yet. And if a subsequent request submission fails in that case, this may lead to a deadlock/infinite wait, because the completion never triggers. like, the completion just... never shows up. ghosted. and then your whole thread is stuck there forever 😭 so please, please don't do that.

---

⭐ RETURN ⭐

It returns the status of the given request, which gets set on completion of the packet. The value is zero on success and negative on failure. zero = slay, negative = not slay 🔥

---

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

---

and that's the whole page, bestie 💜 go forth and wait responsibly. mwah 🎀

sign-off szn 🌈: this little masterpiece lives at ./include/linux/surface_aggreg... and it's dated October 2026. write that down, or don't, it's your life 🦋✨