ssh_ptl_cancel(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ssh_ptl_cancel(9) — like, the packet-cancelling one

Okay bestie, grab a boba, because we're reading a page from the Kernel API Manual together. Yes, kernel docs. Yes, we're doing this. It's giving "I read manpages for fun" and honestly? Iconic. 🎀

✨ NAME ✨

ssh_ptl_cancel — cancel a packet. That's it. That's the whole vibe. 🫶

🌸 SYNOPSIS 🌸

void ssh_ptl_cancel (struct ssh_packet *p );

🦋 ARGUMENTS 🦋

  • p — the packet you want to cancel. The main character of this function, fr fr. 💅

🔥 DESCRIPTION 🔥

So this one cancels a packet. But listen — there are no guarantees on when the completion and release callbacks are gonna get called. Like, it might happen during the execution of this very function, or it might happen at literally any point later. No cap. 😭

Also, bestie, lowkey important: it is not guaranteed that the packet will actually be canceled if the packet gets concurrently completed by another process. 🚨

The one thing ssh_ptl_cancel does promise? The packet will be completed — with success, failure, or cancellation, all three are on the table — and it will be released from the transport layer in a reasonable time-frame. That's the guarantee. That's the whole deal. Periodt. 👑

And here's a fun one: you may call this before the packet has been submitted — but in that case, any later packet submission fails. 💀 So maybe think about that first, iykyk.

🌈 SEE ALSO 🌈

Kernel file ./drivers/platform/surface/aggregator/ssh_packet_layer.c — go read the source, it's right there, slay. 📖

And the whole extended friend group:

💖 bye bestie 💖 — this cutie dropped from ./drivers/platform/surface/agg... back in October 2026, and it's still ssh_ptl_cancel(9) to me. Go cancel some packets responsibly, love u 🎀✨

📦 where this page comes from