filemap_get_folios_dirty(9)

📦 version 7.3.1, in nixpkgs unstable

💖 filemap_get_folios_dirty — Kernel API Manual 💖

okay so bestie, welcome to the filemap_get_folios_dirty(9) page 🌸 this one lives in the Kernel API Manual and honestly it's giving "little helper, big job" energy. let's get into it ✨

✨ NAME ✨

filemap_get_folios_dirty — grab yourself a whole batch of dirty folios 🧚‍♀️ no cap, that's literally the whole vibe.

🦋 SYNOPSIS 🦋

unsigned filemap_get_folios_dirty (struct address_space *mapping ,
pgoff_t *start , pgoff_t end , struct folio_batch *fbatch );

look at that signature. four whole arguments, returning an unsigned. she's tidy, she's specific, she's iconic 💅

🎀 ARGUMENTS 🎀

  • mapping — the address_space you're searching through 🗺️ this is the zone you're digging in.
  • start — the starting folio index. where you begin, bestie 🏁
  • end — the final folio index, and yes it's inclusive so don't forget the last one 🙈
  • fbatch — the batch you're filling up. this is the lil basket you're collecting them in 🧺

💜 DESCRIPTION 💜

so filemap_get_folios_dirty works exactly like filemap_get_folios — same moves, same energy — except the folios it hands back are presumed to be dirty or already undergoing writeback 🫶

and why do we say presumed? because (and this is the important part, don't skip it) we don't block on folio lock, and we also don't wanna miss folios. so the dirty state is a vibe check, not a guarantee ✨ callers who genuinely need to know can recheck the state once they've locked the folio — that's the move 🔥

⚠️ also! this may not return all the dirty folios if the batch gets filled up. so don't come for her if your batch ran out of room 💀

⭐ RETURN ⭐

she returns the number of folios found 🎉 and she also updates start so it's positioned for traversal of the next folio — so you can just keep cruising along 👑

🌈 SEE ALSO 🌈

Kernel file ./mm/filemap.c — and the whole extended fam, fr fr:

and that's the whole page, bestie 🫶 this one's from ./mm, dated October 2026 — like, mark your calendar, she's stamped and everything. mwah 💋 go read some folios 💖

📦 where this page comes from