dax_iomap_fault(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

okay bestie, welcome to the Kernel API Manual corner for dax_iomap_fault(9) β€” yes, this whole page is about one helper and it's lowkey iconic πŸ’…

🌸 NAME 🌸

dax_iomap_fault β€” handle a page fault on a DAX file. That's the whole vibe: DAX file, page fault, handle it ✨


✨ SYNOPSIS ✨

here's the signature, bestie β€” copy it exactly, no freestyling:

vm_fault_t dax_iomap_fault (struct vm_fault *vmf , unsigned int order ,
unsigned long *pfnp , int *iomap_errp , const struct iomap_ops *ops );

πŸ’– ARGUMENTS πŸ’–

okay so every parameter, and what it's giving:

  • vmf β€” the description of the fault. literally the fault's whole story 🫢
  • order β€” order of the page to fault in. yes ma'am, the page order πŸ”₯
  • pfnp β€” PFN to insert for synchronous faults if fsync is required. so that's the synchronous-faults-with-fsync situation, no cap πŸ’…
  • iomap_errp β€” storage for detailed error code in case of error. so when things go πŸ’€, the detailed error code can live here
  • ops β€” Iomap ops passed from the file system. handed over by the fs, periodt πŸŽ€

πŸ¦‹ DESCRIPTION πŸ¦‹

When a page fault occurs, filesystems may call this helper in their fault handler for DAX files. that's the main character moment right there 🌟

dax_iomap_fault assumes the caller has done all the necessary locking for page fault to proceed successfully β€” so like, do your locking first, bestie, because this helper is assuming it's already handled πŸ™ˆ


πŸŽ€ SEE ALSO πŸŽ€

Kernel file ./fs/dax.c is the place, and these are the linked faves:


mwah πŸ’‹ this page came from ./fs, dated October 2026, and it's all about dax_iomap_fault(9) β€” source/version and date, all accounted for 🫢✨

πŸ“¦ where this page comes from