ssh_ptl_shou...p_ack_packet(9)

💅 ssh_ptl_shou...p_ack_packet(9) 💅

okay bestie, welcome to the Kernel API Manual corner ✨ today's main character is a tiny little error-injection hook, and honestly? it's giving "chaos testing but make it SSH packet layer" 🦋

🎀 NAME 🎀

ssh_ptl_should_drop_ack_packet — Error injection hook to drop ACK packets.

✨ SYNOPSIS ✨

bool ssh_ptl_should_drop_ack_packet (void );

🌸 ARGUMENTS 🌸

• void — no arguments. literally none, bestie 🫶

🦋 DESCRIPTION 🦋

So this hook is useful to test detection and handling of automated re-transmits by the EC. Specifically, we're talking about packets that the EC considers not-ACKed but the driver already considers ACKed — and that whole mismatch happens due to a dropped ACK 😭

In this case, the EC re-transmits the packet-to-be-ACKed, and the driver should detect it as duplicate/already handled 👑 Important vibe check, though: the driver should still send an ACK for the re-transmitted packet. no cap, that part matters 💅

🌈 SEE ALSO 🌈

• Kernel file ./drivers/platform/surface/aggregator/ssh_packet_layer.c
• ssh_ptl_should_drop_nak_packet(9), ssh_ptl_should_drop_dsq_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)

okay that's the whole page, bestie 🫶 this gem came from ./drivers/platform/surface/agg... and it's dated October 2026 — mwah 💋