hmm_dma_map_free(9)

📦 version 7.3.1, in nixpkgs unstable

💖 hmm_dma_map_free(9) 💖

okay so first things first: this is a page from the Kernel API Manual, and it's short, it's sweet, and it's literally just "clean up after yourself." the whole personality of this function is responsible friend who does the dishes before leaving the party. we love her for that 🫶

✨ NAME ✨

hmm_dma_map_free — as the page itself puts it, "iFree HMM map structure" 😭 (yes bestie, the manpage really does say "iFree", and no, we are not fixing it, it's iconic and it's part of history) 💅

🦋 SYNOPSIS 🦋

void hmm_dma_map_free (struct device *dev , struct hmm_dma_map *map );

that's it. that's the whole call. no return value (it's void, so like... she gives nothing back, she just does the work, main character energy honestly 👑).

🌸 ARGUMENTS 🌸

  • dev — the device you're freeing the structure from. yeah, it needs to know which device, don't ask her to guess 💀
  • map — the HMM map, the one holding all the various lists and state. this is the thing getting yeeted into the void. ngl she's carrying a lot: lists, state, the whole vibe check 📋

🎀 DESCRIPTION 🎀

so what does she actually do? pretty much what it says on the tin, bestie: she frees the HMM map structure and all the lists it contains. every list, inside the map, gone. freed. released. ✨ clean slate ✨

like, don't come back looking for those lists afterwards, because they are not there. that's the whole job and she is obsessed with doing it properly. no cap.

🔥 SEE ALSO 🔥

the kernel file ./mm/hmm.c is where this all lives, and then the whole friend group:

iykyk — go read hmm_dma_map_alloc(9) if you want to see the before picture, and hmm_dma_unmap_pfn(9) if you're the type who likes to unpack before you free 😌

heads up bestie: this is a free function, so once you call it, that map and its lists are donezo. don't go touching them after, fr fr. 🙈

and that's the whole page! 🌈 straight from ./mm, dated October 2026, filed under hmm_dma_map_free(9) — short king of a manpage, slayed the assignment, periodt 💜🍓✨

📦 where this page comes from