ssh_ctrl_packet_alloc(9)

💖 ssh_ctrl_packet_alloc(9) 💖

okay so bestie, welcome to the Kernel API Manual page for ssh_ctrl_packet_alloc(9) — yes that's the whole title, she's a mouthful, but we move 💅

---

✨ NAME ✨

ssh_ctrl_packet_alloc — grab a packet out of the control packet cache. that's it, that's the vibe 🎀

---

🌸 SYNOPSIS 🌸

int ssh_ctrl_packet_alloc (struct ssh_packet **packet , struct ssam_span
*buffer , gfp_t flags );

literally three args, no cap, and she returns an int 🫶

---

🦋 ARGUMENTS 🦋

• packet — where the pointer to the newly allocated packet should be stored. like, this is the spot you hand her so she can drop the pointer in 💖
• buffer — the buffer corresponding to this packet. the lil partner-in-crime buffer 🌸
• flags — flags used for allocation. the usual allocation-flag situation ✨

---

👑 DESCRIPTION 👑

so what does she actually do? she allocates a packet and the corresponding transport buffer, both from the control packet cache. iconic. then she sets the packet's buffer reference to the allocated buffer — so the packet knows which buffer is hers 🎀

important, bestie, listen to me: the packet must be freed via ssh_ctrl_packet_free, and that will also free the corresponding buffer. so do not free the corresponding buffer separately. that's a no-no. 🙈

she's intended to be used with ssh_ptl_ctrl_packet_ops as packet operations. iykyk 💅

---

🔥 RETURN 🔥

• returns zero on success — slay, we love a zero 💖
• returns -ENOMEM if the allocation failed — 😭 the memory said no

---

🌈 SEE ALSO 🌈

the whole friend group, fr fr:

• 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_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_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)

---

that's the whole page, bestie ✨💜🌸

sign-off vibes: this absolute queen comes to you from ./drivers/platform/surface/agg... (the source/version, a lil truncated but iconic) and she's dated October 2026 — yes, october, and yes, 2026. main character energy in the manual page header too, ssh_ctrl_packet_alloc(9), periodt 💅🫶