sshp_buf_span_from(9)

💅 sshp_buf_span_from(9) — like, the kernel API manual bestie 🫶

okay so real talk, this page lives in the Kernel API Manual — section 9, the one for all the kernel-internals girlies — and it's about sshp_buf_span_from. yes it's a mouthful. no we're not renaming it. it's iconic, we deal. ✨

🌸 NAME 🌸

sshp_buf_span_from — initialize a span from the given buffer and offset. that's the whole vibe. we're making a span, and it's starting from a buffer at a specific offset. slay.

🎀 SYNOPSIS 🎀

void sshp_buf_span_from (struct sshp_buf *buf , size_t offset , struct
ssam_span *span );

that's it, that's the whole signature. three args, returns void, no drama. 💜

🦋 ARGUMENTS 🦋

• buf — the buffer we're making the span from. the source material, the main character, the origin story.
• offset — where in the buffer the span should start. like a starting line, but for bytes.
• span — the span we're initializing. this one's an output, so we're writing into it, not reading from it. she's the canvas, bestie. 🎨

✨ DESCRIPTION ✨

so what does it actually do? it initializes the span you handed it so that it points at the memory at the given offset inside the buffer. cute. and the length of the span? that gets capped by the number of bytes used in the buffer after the offset — aka the bytes remaining after the offset. so if there's not a ton of buffer left, the span just gets shorter. length vibe check: capped. 🧚

⚠️ warning, and this is a real one, not a drill ⚠️ this function does NOT validate that offset is less than or equal to the number of bytes used in the buffer, and it does not validate that offset is less than or equal to the buffer capacity either. nope. not doing it. this must be guaranteed by the caller. so like… that's on you, bestie. please check your offsets. i'm begging. 😭💀

👑 SEE ALSO 👑

• Kernel file ./drivers/platform/surface/aggregator/ssh_parser.h struct sshp_buf(9)
• sshp_buf_init(9)
• sshp_buf_alloc(9)
• sshp_buf_free(9)
• sshp_buf_drop(9)
• sshp_buf_read_from_fifo(9)

okay that's the page!! go forth and span responsibly 🦋💖 this one's from ./drivers/platform/surface/agg..., dated October 2026, and it says sshp_buf_span_from(9) at the bottom like a little signature. periodt. 💅⭐