cp_free(9)

💅 cp_free(9) — Kernel API Manual, bestie edition ✨

okay so like, this whole page lives in the Kernel API Manual and it's about cp_free — literally the cleanup bestie of the channel program world 🧹💖

---

🦋 NAME 🦋

cp_free — frees the resources for a channel program. yes that's it, that's the whole job, and she does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

void cp_free (struct channel_program *cp );

---

🎀 ARGUMENTS 🎀

• cp — the channel_program you're doing the operation on. that's the one, the main character of this whole function 🫶

---

✨ DESCRIPTION ✨

so what she actually does: this unpins the memory pages and frees the memory space occupied by cp 🔥

but listen — that cp MUST have been returned by a previous call to cp_init. like, that's the vibe check. that's the requirement.

⚠️ and if it wasn't? undefined behavior occurs. not being dramatic, that's literally what the page says 😭💀 so please, only pass in something cp_init actually handed you, okay? i'm not gonna say it twice… well i might, but still 😤

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/s390/cio/vfio_ccw_cp.c
• ccwchain_calc_length(9)
• cp_init(9)
• cp_prefetch(9)
• cp_get_orb(9)
• cp_update_scsw(9)
• cp_iova_pinned(9)

like, the whole friend group honestly 👑✨

---

source: ./drivers/s390/cio — and this icon was dropped October 2026 🗓️💜 mwah, go free your memory responsibly bestie, ily 🍓🧚‍♀️