prepare_dma_bufs(9)

✨ prepare_dma_bufs(9) ✨

okay so real talk, this is a page from the Kernel API Manual and the function we're obsessing over today is prepare_dma_bufs 💅 like yes she's that girl. She gets the DMA buffer all cute and ready for transferring firmware fragments. lowkey essential, ngl.

---

🌸 NAME 🌸

prepare_dma_bufs — gets the DMA buffer prepped and pretty for moving firmware fragments around 🎀

---

🦋 SYNOPSIS 🦋

int prepare_dma_bufs (struct ishtp_device *dev , const struct firmware
*ish_fw , struct loader_xfer_dma_fragment *fragment , void **dma_bufs ,
u32 fragment_size , u32 fragment_count );

like, look at her. six arguments, zero notes 💀 she knows what she's doing.

---

💖 ARGUMENTS 💖

• dev — the ISHTP device, aka the main character of this whole operation 👑
• ish_fw — the ISH firmware, the whole reason we're here fr fr
• fragment — the ISHTP firmware fragment descriptor, she's got the deets 🎀
• dma_bufs — the array of DMA fragment buffers, the squad of buffers, if you will 🫶
• fragment_size — the size of a single DMA fragment, one (1) fragment's measurements ✨
• fragment_count — number of fragments, so we know how many besties are in the array 🌈

---

⭐ RETURN ⭐

0 on success, and a negative error code on failure 😭 so like, check her return value, bestie. 0 means slay, negative means not slay.

---

💜 SEE ALSO 💜

• Kernel file ./drivers/hid/intel-ish-hid/ishtp/loader.c — go read the source, it's giving lore 📖
• loader_write_message(9)
• loader_xfer_cmd(9)
• release_dma_bufs(9)
• request_ish_firmware(9)
• ishtp_loader_work(9)

like a whole friend group, honestly 🧚

---

ngl the whole family lives over in ./drivers/hid/intel-ish-hid/ishtp — that's the source/version vibe, and this page is dated October 2026 🗓️

and that's the page, periodt 🎀 go forth and prepare those buffers, iykyk 💅🔥