STRUCT DAX_REGION(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… struct dax_region(9) β€” like, the actual manual page, bestie ✨

okay so this is a page straight outta the Kernel API Manual, and it's all about struct dax_region β€” the mapping infrastructure for dax devices πŸŽ€. Yes, infrastructure. It's giving scaffolding-but-make-it-serve-caffeine. Let's get into it πŸ’–


✨ NAME ✨

struct dax_region β€” the mapping infrastructure for dax devices πŸ¦‹

lowkey the whole personality of this thing is "I hold the vibes together so the dax devices can do their thing." iconic behavior, no cap πŸ‘‘


🌸 SYNOPSIS 🌸

here's the whole struct, exactly as it lives, don't touch, don't rename, just admire:

struct dax_region {
    int id;
    int target_node;
    struct kref kref;
    struct device *dev;
    unsigned int align;
    struct ida ida;
    struct resource res;
    struct device *seed;
    struct device *youngest;
 };

look at her. nine members. main character energy fr fr πŸ’…


🫢 Members 🫢

every single field, and what it's actually here for πŸ‘‡

  • id β€” a kernel-wide unique region for a memory range. like a government name but for memory. one of one, periodt πŸ†”
  • target_node β€” the effective numa node if this memory range is onlined. yes, if β€” conditional queen πŸ™ˆ
  • kref β€” the refcount you pin while other agents have a need to do lookups. basically holding the door open for your friends πŸšͺπŸ’–
  • dev β€” the parent device backing this region. the parent! the backer! the one paying rent 🏠
  • align β€” the allocation and mapping alignment for child dax devices. everything lines up. literally. πŸ“βœ¨
  • ida β€” the instance id allocator. handing out ids like a club promoter with a clipboard 🎟️
  • res β€” the resource tree that tracks instance allocations. tree. tracking. very organized of her 🌳
  • seed β€” allows userspace to find the first unbound seed device. first! unbound! mysterious! 🌱
  • youngest β€” allows userspace to find the most recently created device. the baby of the family, freshly made πŸ‘ΆπŸ”₯
ngl, the seed and youngest duo is such a cute pairing β€” first-ever and newest-ever, both findable from userspace 🧚

🌈 SEE ALSO 🌈

go read these next, iykwim πŸ‘€

  • Kernel file ./drivers/dax/dax-private.h
  • struct dax_mapping(9)
  • struct dev_dax_range(9)
  • struct dev_dax(9)

all of them live together in ./drivers/dax and honestly? found family 🫢


that's the whole page bestie, every member accounted for, nothing skipped, nothing invented πŸ’œ mwah πŸ’‹

source/version: ./drivers/dax Β· date: October 2026 β€” slay, dated, and official βœ¨πŸŽ€πŸ’–

πŸ“¦ where this page comes from