xilinx_dma_a...x_descriptor(9)

💅 xilinx_dma_a...x_descriptor(9) 💅

okay bestie, grab your iced coffee because we're diving into the Kernel API Manual ✨ — yes this is that kernel, the big one. This page is all about one lil function that hands out transaction descriptors, and honestly? she's a whole vibe.

---

🌸 NAME 🌸

xilinx_dma_alloc_tx_descriptor — literally just Allocate transaction descriptor. that's it. that's the job. no cap 💅

---

✨ SYNOPSIS ✨

struct xilinx_dma_tx_descriptor * xilinx_dma_alloc_tx_descriptor (struct
xilinx_dma_chan *chan );

she takes one (1) argument and returns a pointer to a struct xilinx_dma_tx_descriptor. main character signature energy fr fr 🫶

---

🎀 ARGUMENTS 🎀

• chan — the Driver specific DMA channel, i.e. the channel this driver cares about. it's giving "you already know which one" 🦋

---

👑 RETURN 👑

on success you get the allocated descriptor — iconic, we love a win 🌈. and on failure you get NULL 😭 so like… check it. pls check it.

---

💜 SEE ALSO 💜

okay this is the part where the group chat gets long, but every single one of these matters so we're listing them all, no skips, no ✂️:

• the kernel file ./drivers/dma/xilinx/xilinx_dma.c — the source of truth bestie 🍓
• struct xilinx_vdma_desc_hw(9)
• struct xilinx_axidma_desc_hw(9)
• struct xilinx_aximcdma_desc_hw(9)
• struct xilinx_cdma_desc_hw(9)
• struct xilinx_vdma_tx_segment(9)
• struct xilinx_axidma_tx_segment(9)
• struct xilinx_aximcdma_tx_segment(9)
• struct xilinx_cdma_tx_segment(9)
• struct xilinx_dma_tx_descriptor(9)
• struct xilinx_dma_chan(9)
• enum xdma_ip_type(9)
• struct xilinx_dma_device(9)
• vdma_desc_write_64(9)
• xilinx_dma_get_metadata_ptr(9)
• xilinx_vdma_alloc_tx_segment(9)
• xilinx_cdma_alloc_tx_segment(9)
• xilinx_axidma_alloc_tx_segment(9)
• xilinx_aximcdma_alloc_tx_segment(9)
• xilinx_dma_free_tx_segment(9)
• xilinx_mcdma_free_tx_segment(9)
• xilinx_cdma_free_tx_segment(9)
• xilinx_vdma_free_tx_segment(9)
• xilinx_dma_free_tx_descriptor(9)
• xilinx_dma_free_desc_list(9)
• xilinx_dma_free_descriptors(9)
• xilinx_dma_free_chan_resources(9)
• xilinx_dma_get_residue(9)
• xilinx_dma_chan_handle_cyclic(9)
• xilinx_dma_chan_desc_cleanup(9)
• xilinx_dma_do_tasklet(9)
• xilinx_dma_alloc_chan_resources(9)
• xilinx_dma_calc_copysize(9)
• xilinx_dma_tx_status(9)
• xilinx_dma_stop_transfer(9)
• xilinx_cdma_stop_transfer(9)
• xilinx_dma_start(9)
• xilinx_vdma_start_transfer(9)
• xilinx_cdma_start_transfer(9)
• xilinx_dma_start_transfer(9)
• xilinx_mcdma_start_transfer(9)
• xilinx_dma_issue_pending(9)
• xilinx_dma_device_config(9)
• xilinx_dma_complete_descriptor(9)
• xilinx_dma_reset(9)
• xilinx_dma_chan_reset(9)
• xilinx_mcdma_irq_handler(9)
• xilinx_dma_irq_handler(9)
• append_desc_queue(9)
• xilinx_dma_tx_submit(9)
• xilinx_vdma_dma_prep_interleaved(9)
• xilinx_cdma_prep_memcpy(9)
• xilinx_dma_prep_peripheral_dma_vec(9)
• xilinx_dma_prep_slave_sg(9)
• xilinx_dma_prep_dma_cyclic(9)
• xilinx_mcdma_prep_slave_sg(9)
• xilinx_dma_terminate_all(9)
• xilinx_vdma_channel_set_config(9)
• xilinx_dma_chan_remove(9)
• xilinx_dma_chan_probe(9)
• xilinx_dma_child_probe(9)
• of_dma_xilinx_xlate(9)
• xilinx_dma_probe(9)
• xilinx_dma_remove(9)

like… that's the whole friend group 💀 but every one of them is invited, periodt.

---

lowkey reminder bestie: NULL on failure is a real return value, so don't go dereferencing it and then acting surprised 😭 that's not the slay you think it is.

---

mwah 💋 that's the page! this lil gem lives in ./drivers/dma/xilinx, and this particular printing is stamped October 2026 — so if you're reading it, congrats, you're in the future and you're also now a Xilinx DMA descriptor expert. 💅✨🎀🦋🌸