adm_prep_slave_sg(9)
π adm_prep_slave_sg(9) β like, the whole glow-up
okay so bestie, welcome to the Kernel API Manual β¨ this little page is all about adm_prep_slave_sg(9), and yes it's as niche as it sounds. it's a kernel function, it's in the DMA world, and it's lowkey iconic for what it does. let's get into it π
β¨ NAME β¨
adm_prep_slave_sg β it preps a slave sg transaction. that's it, that's the whole name, no cap π
π¦ SYNOPSIS π¦
here's the signature, copy-pasted with love and zero typos, bestie:
struct dma_async_tx_descriptor * adm_prep_slave_sg (struct dma_chan
*chan , struct scatterlist *sgl , unsigned int sg_len , enum
dma_transfer_direction direction , unsigned long flags , void *context
);
the way it returns a struct dma_async_tx_descriptor *β¦ main character energy fr fr π
πΈ ARGUMENTS πΈ
okay now the little cast of characters, one by one, no skipping:
chanβ the dma channel π« like, the actual channel this whole thing runs onsglβ the scatter gather list π yes, the list itself, the whole lineupsg_lenβ the length of sg π how long that list is being, basicallydirectionβ the DMA transfer direction π§ it's anenum dma_transfer_direction, so it knows which way the data's goingflagsβ the DMA flags π© the littleunsigned longof optionscontextβ transfer context, and ngl it's marked (unused) π so yeah, it's there, it's invited to the party, it just doesn't dance
no cap, context is literally listed as unused in the original β so don't come for me, I'm just the messenger π
π«Ά SEE ALSO π«Ά
bestie, this is the friend group π―ββοΈ the kernel file is ./drivers/dma/qcom/qcom_adm.c and here's everyone else in the circle:
adm_free_chan(9)adm_get_blksize(9)adm_process_fc_descriptors(9)adm_process_non_fc_descriptors(9)adm_terminate_all(9)adm_start_dma(9)adm_dma_irq(9)adm_tx_status(9)adm_issue_pending(9)adm_dma_free_desc(9)adm_dma_xlate(9)
go read them all, i'll wait π
π sign-off π
this page lives under ./drivers/dma/qcom in the Kernel API Manual, and it's dated October 2026 β that's the version, that's the date, and honestly? she ate. periodt π
β¨
you're now officially caught up on adm_prep_slave_sg(9) β go forth and prep those slave sg transactions, queen ππ¦π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms