ssh_ptl_shou...p_dsq_packet(9)

💅 ssh_ptl_should_drop_dsq_packet(9) — the Kernel API Manual moment 🎀

okay so bestie, welcome to the Kernel API Manual, section 9, and the star of the show is ssh_ptl_should_drop_dsq_packet. yes it's a long name. yes it's iconic. we move 💅

---

✨ NAME ✨

ssh_ptl_should_drop_dsq_packet — literally an error injection hook whose whole job is to drop a sequenced data packet 🫶

---

🌸 SYNOPSIS 🌸

bool ssh_ptl_should_drop_dsq_packet (void );

---

🦋 ARGUMENTS 🦋

• void — no arguments. nothing. zero. she takes nothing and she returns a bool, main character energy fr fr ✨

---

🔥 DESCRIPTION 🔥

So this one is genuinely useful for testing the driver's re-transmit timeout, no cap. Here's the vibe:

If the data packet has not been ACKed after a certain time, the driver should re-transmit the packet — up to a limited number of times, and that limit is defined in SSH_PTL_MAX_PACKET_TRIES 👑

so yeah, she's an error injection hook, she makes packets vanish on purpose, and she does it so you can test the retransmit path. obsessed 🎀

---

💜 SEE ALSO 💜

the whole friend group 🫶:

• Kernel file ./drivers/platform/surface/aggregator/ssh_packet_layer.c
• ssh_ptl_should_drop_ack_packet(9)
• ssh_ptl_should_drop_nak_packet(9)
• ssh_ptl_should_fail_write(9)
• ssh_ptl_should_corrupt_tx_data(9)
• ssh_ptl_should_corrupt_rx_syn(9)
• ssh_ptl_should_corrupt_rx_data(9)
• ssh_packet_get(9)
• ssh_packet_put(9)
• ssh_packet_init(9)
• ssh_ctrl_packet_cache_init(9)
• ssh_ctrl_packet_cache_destroy(9)
• ssh_ctrl_packet_alloc(9)
• ssh_ctrl_packet_free(9)
• ssh_ptl_tx_wakeup_packet(9)
• ssh_ptl_tx_start(9)
• ssh_ptl_tx_stop(9)
• ssh_ptl_submit(9)
• ssh_ptl_cancel(9)
• ssh_ptl_rx_start(9)
• ssh_ptl_rx_stop(9)
• ssh_ptl_rx_rcvbuf(9)
• ssh_ptl_shutdown(9)
• ssh_ptl_init(9)
• ssh_ptl_destroy(9)

---

lowkey slay, that's the whole page 💖

and that's a wrap bestie 🌈 — this came out of ./drivers/platform/surface/agg..., dated October 2026, and the page is still called ssh_ptl_shou...p_dsq_packet(9) (yes, the header and footer both truncate her name like that, she's mysterious like that 🙈). periodt. 💅