acpi_dma_con...ler_register(9)

📦 version 7.3.1, in nixpkgs unstable

💅 acpi_dma_controller_register(9) — like, the whole vibe

okay so bestie, welcome to the Kernel API Manual ✨ this is the page for acpi_dma_controller_register, and yes the title gets truncated in the header (acpi_dma_con...ler_register(9)) because even man pages have a character limit, we don't make the rules 🎀

🌸 NAME 🌸

acpi_dma_controller_register — register a DMA controller with the ACPI DMA helpers. that's it, that's the whole name, slay 💅

✨ SYNOPSIS ✨

int acpi_dma_controller_register (struct device *dev , struct dma_chan
*(*acpi_dma_xlate) (struct acpi_dma_spec *, struct acpi_dma *) , void
*data );

like literally copy that exactly, don't @ me, it's a function pointer in there and she's iconic 🦋

🫶 ARGUMENTS 🫶

  • dev — the struct device of the DMA controller. it's giving "who am i, where do i live" energy, but for hardware 🔥
  • acpi_dma_xlate — the translation function, and honestly the main character here 👑 it converts a dma specifier into a dma_chan structure. it takes a struct acpi_dma_spec * and a struct acpi_dma *, no cap.
  • data — pointer to controller-specific data, which the translation function gets to use. it's the little bag of snacks your xlate function brings along 🍓

💜 DESCRIPTION 💜

so here's the tea: any memory that gets allocated should be freed with the appropriate acpi_dma_controller_free call. like, please don't just leave it there, that's not the vibe 😭

⭐ RETURN ⭐

0 on success, or the appropriate errno value on error. zero means we ate, anything else means something went sideways 💀

🌈 SEE ALSO 🌈

kernel file ./drivers/dma/acpi-dma.c — go read her, she's right there 🧚

and then the whole friend group:

ngl, if you're registering a DMA controller, you're lowkey doing the most important work in the whole kernel. no cap. 🫡

and that's the page, bestie!! brought to you from ./drivers/dma, dated October 2026, filed under acpi_dma_con...ler_register(9) — mwah 💖✨ see you in the next man page, periodt 🎀

📦 where this page comes from