ssam_request_sync_init(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ssam_request_sync_init — Kernel API Manual energy ✨

Okay bestie, so we're in the kernel API manual today and the star of the show is ssam_request_sync_init(9). Yes, the section is 9, yes that's the kernel one, no we're not scared of it. Let's get into it 🫶

✨ NAME ✨

ssam_request_sync_init — literally just "Initialize a synchronous request struct." That's the whole vibe. It sets up your request so the rest of the pipeline can do its thing 💖

🌸 SYNOPSIS 🌸

int ssam_request_sync_init (struct ssam_request_sync *rqst , enum
ssam_request_flags flags );

Two arguments, one int coming back at you. Clean. Iconic. No notes 🔥

🎀 ARGUMENTS 🎀

  • rqst — the request you're about to initialize. That's your main character right there 👑
  • flags — the request flags. The enum ssam_request_flags kind. Pick good ones or see RETURN below 😭

🦋 DESCRIPTION 🦋

So what it does: it initializes the given request struct. That's it. That's the job ✨

But listen — bestie, read this part twice because it's important — it does NOT initialize the request message data. Nope. Not even a little. That part is on you, and you have to do it explicitly after this call:

  • do it via ssam_request_sync_set_data
  • and the actual message data has to be written via ssam_request_write_data

The way this function handles the struct and then dips on the data is honestly so real of it 💀 but fr fr, don't forget the second step or you're gonna have a bad time 🙈

⭐ RETURN ⭐

Returns zero on success 🎉 or -EINVAL if the given flags are invalid 🚩 That's the whole return contract, no cap.

Lowkey important: -EINVAL here means your flags were invalid, so check those first before you go blaming anything else 💅

💜 SEE ALSO 💜

The kernel file we're living in: ./drivers/platform/surface/aggregator/controller.c — go read it, it's giving source of truth 🌈

And the whole extended friend group, all in section 9:

Iykyk, that's the whole roster 💀💖

And that's the page, bestie!! This one came from ./drivers/platform/surface/agg... (that's the source/version tag, you know the one) and it's dated October 2026 🗓️✨ Go init your request struct responsibly, remember your data step, and slay 🧚‍♀️💜

📦 where this page comes from