filemap_fda..._keep_errors(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

hey bestie, welcome to the filemap_fda..._keep_errors(9) page from the Kernel API Manual πŸ’– this one is lowkey iconic if you're into writeback waiting, and yes we're gonna get through every single detail together ✨

🌸 NAME 🌸

filemap_fdatawait_range_keep_errors β€” wait for writeback to complete πŸŽ€

✨ SYNOPSIS ✨

here's the exact signature, bestie β€” copy it character for character, no edits:

int filemap_fdatawait_range_keep_errors (struct address_space *mapping , loff_t start_byte , loff_t end_byte );

πŸŽ€ ARGUMENTS πŸŽ€

  • mapping β€” the address space structure to wait for. like, this is the thing you're waiting on until writeback is done πŸ’…
  • start_byte β€” offset in bytes where the range starts. beginning of the wait zone ✨
  • end_byte β€” offset in bytes where the range ends, and yes bestie it is inclusive 🫢 don't forget that part

πŸ’… DESCRIPTION πŸ’…

okay so what it actually does: it walks the list of under-writeback pages of the given address space in the given range, and waits for all of them. all of them, no cap πŸ”₯

the key difference from filemap_fdatawait_range is that this function does not clear the error status of the address space. that's the whole β€œkeep errors” moment, iykyk 😭

use this function if callers don't handle errors themselves. expected call sites are system-wide / filesystem-wide data flushers: e.g. sync(2), fsfreeze(8) β€” iconic flusher behavior only ✨

heads up bestie: it keeps the error status, so don't treat it like the version that clears it πŸ’€

πŸ¦‹ SEE ALSO πŸ¦‹

kernel file: ./mm/filemap.c

the whole reference squad, in order:


okay that's the whole page, bestie πŸ’– source/version says ./mm, date says October 2026, and the page is filemap_fda..._keep_errors(9) β€” go wait on those pages and slay βœ¨πŸ¦‹

πŸ“¦ where this page comes from