devm_iio_dm..._with_handle(9)

✨ devm_iio_dmaengine_buffer_setup_with_handle(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 this one's a little function from the kernel with a very long name, but don't panic — it's actually super straightforward. Let's get into it 🫶

---

🌸 NAME 🌸

devm_iio_dmaengine_buffer_setup_with_handle — literally just sets up a DMA buffer for an IIO device. That's the whole vibe 💅

---

🦋 SYNOPSIS 🦋

int devm_iio_dmaengine_buffer_setup_with_handle (struct device *dev ,
       struct iio_dev *indio_dev , struct dma_chan *chan , enum
       iio_buffer_direction dir );

---

🎀 ARGUMENTS 🎀

• dev — the device that gives you devm ownership (i.e. the managed-lifetime situation, so you don't have to manually free it later — iconic behavior tbh)
• indio_dev — the IIO device this buffer is getting attached to 🍓
• chan — the DMA channel. your DMA channel. go get it, main character 💅
• dir — the direction of the buffer, in or out. pick a lane bestie ✨

---

🌈 DESCRIPTION 🌈

So what actually happens here? It allocates a brand-new IIO buffer using devm_iio_dmaengine_buffer_alloc, then attaches that buffer to an IIO device using iio_device_attach_buffer. Two steps, both handled. slay 🔥

It also appends the INDIO_BUFFER_HARDWARE mode to the supported modes of the IIO device — so the device officially supports that mode now. periodt 👑

And the tea ☕: this is the same as devm_iio_dmaengine_buffer_setup_ext, the one difference being that the caller manages requesting and releasing the DMA channel handle themselves. that's it, that's the whole distinction, no cap 💀

---

⭐ SEE ALSO ⭐

• Kernel file ./drivers/iio/buffer/industrialio-buffer-dmaengine.c — go read the source if you want the full lore, iykyk 📖
• iio_dmaengine_buffer_alloc(9)
• iio_dmaengine_buffer_free(9)
• iio_dmaengine_buffer_teardown(9)
• iio_dmaengine_buffer_setup_ext(9)
• devm_iio_dmaengine_buffer_setup_ext(9)

---

and that's the page bestie 🌸 this gem lives over in ./drivers/iio/buffer, dated October 2026, and it's part of the Kernel API Manual — the same page title we opened with, devm_iio_dm..._with_handle(9), coming right back around at the end like a true full-circle moment 🎀💜 love that for us, mwah 💋