adm_free_chan(9)
π adm_free_chan β like, the whole page
okay so bestie, welcome to section 9 of the Kernel API Manual β yes, the kernel API one, we're in the big leagues now π this little icon is called adm_free_chan and honestly? she's the cleanup queen. no cap.
β¨ NAME β¨
adm_free_chan β frees the dma resources that are tied to this specific channel π that's it, that's the job, and she does it flawlessly.
πΈ SYNOPSIS πΈ
void adm_free_chan (struct dma_chan *chan );
literally just one call, one argument, returns nothing (void, so don't come looking for a return value, she gives you nothing back and that's iconic of her π«Ά).
π¦ ARGUMENTS π¦
chanβ the dma channel. the main character of this whole situation π you hand her the channel, she handles the rest.
π₯ DESCRIPTION π₯
so what does she actually do? she frees all the allocated descriptors that are associated with this channel πβ¨ every single one. not some. not most. all. it's giving "spring cleaning but make it kernel-level."
ngl this is the function you call when you're done with a channel and you want all those descriptors yeeted back into the void so nothing leaks. she's not dramatic about it, she just does it. periodt.
lowkey important: this is the teardown girlie β she clears the descriptors for the channel you pass in, and that's the whole scoop fr fr. don't expect her to do anything else, she's very focused π
π SEE ALSO π
the kernel file ./drivers/dma/qcom/qcom_adm.c β that's where all this lives, go read it, iykyk π and while you're there, say hi to the whole squad:
adm_get_blksize(9)adm_process_fc_descriptors(9)adm_process_non_fc_descriptors(9)adm_prep_slave_sg(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)
the whole friend group, all in one place ππ
aaaand that's the page!! π this absolute baddie of a manpage comes to you from ./drivers/dma/qcom, dated October 2026 β mwah, ily, go free those descriptors bestie π
β¨π
π¦ 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