sshp_parse_command(9)

💅 sshp_parse_command(9) — a Kernel API Manual moment 🫶

okay so bestie, you're in the Kernel API Manual section and the star of the show is sshp_parse_command. she parses SSH command frame payloads and she does it iconically. no cap.

---

✨ SYNOPSIS ✨

int sshp_parse_command (const struct device *dev , const struct
       ssam_span *source , struct ssh_command **command , struct ssam_span
       *command_data );

like, look at her go 💅 four params, one int return, zero notes.

---

🎀 ARGUMENTS 🎀

• dev — the device used for logging. she's just here for the vibes and the log lines 🪵
• source — the source to parse from. the raw material, the moment, the material ✨
• command — the parsed command, and yes it's an output (struct ssh_command **), she writes back to you 🫶
• command_data — the parsed command data / payload, also an output (struct ssam_span *) 💖

---

🌸 DESCRIPTION 🌸

so what she actually does: parses and validates a SSH command frame payload. she sets the command pointer to the command header, and sets the command_data span to the command data — i.e. the payload of the command. and if the command doesn't have any associated data/payload? you get a zero-length span, which is giving "nothing but make it valid" 💀

highkey important: this function does not check the frame-payload-type field. that check is on you, bestie — the caller has to do it before calling this function. no cap, don't skip it.

the source parameter should be the complete frame payload, like the one returned by the sshp_parse_frame command. literally just hand her the whole thing.

and the way she's efficient?? this function does not copy any data. she only validates the frame payload data and sets pointers (and length values) to indicate the respective parts. zero copying, all pointing, main character energy 👑

---

🔥 RETURN 🔥

returns zero on success — slay 💖

or -ENOMSG if source doesn't represent a valid command-type frame payload, i.e. it's too short. too short = not the vibe, sorry 😭

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/platform/surface/aggregator/ssh_parser.c
• sshp_validate_crc(9)
• sshp_starts_with_syn(9)
• sshp_find_syn(9)
• sshp_parse_frame(9)

the whole friend group fr fr 🫶 go read them, iykyk

---

ngl, the whole "validate then point at stuff" thing is lowkey elegant. obsessed. but pls remember the frame-payload-type check is your job, not hers. 🙈

---

sign-off time 🧚 this page lives at ./drivers/platform/surface/agg... and it's dated October 2026. catch you in the next section, bestie — mwah 💋✨