STRUCT IO_PGTABLE(9)

💖 struct io_pgtable(9) 💖

okay so bestie, this is the Kernel API Manual and we're about to have a whole moment about page tables. strap in 🎀

---

🌸 NAME 🌸

struct io_pgtable — the internal structure that describes a set of page tables. that's it, that's the vibe. it's the little container that holds everything together 💅

---

✨ SYNOPSIS ✨

struct io_pgtable {
    enum io_pgtable_fmt     fmt;
    void *cookie;
    struct io_pgtable_cfg   cfg;
    struct io_pgtable_ops   ops;
 };

like. look at her. four fields. absolutely iconic. no notes 👑

---

🦋 Members 🦋

• fmt — the page table format. that's the whole personality of the page table right there, the enum io_pgtable_fmt situation.
• cookie — an opaque token that the IOMMU driver hands over, and it gets passed right back to any callback routines. it's literally a little gift the driver leaves for itself later 🍪 nobody else peeks inside it, that's the whole point, iykyk.
• cfg — a copy of the page table configuration. not a pointer, not a reference, a copy. she's got her own.
• ops — the page table operations that are in use for this particular set of page tables. the actual verbs, the doing part, the main character energy 🔥

---

🎀 SEE ALSO 🎀

kernel file ./include/linux/io-pgtable.h — that's where the source of truth lives, bestie.

and these absolute legends:

• struct iommu_flush_ops(9)
• struct io_pgtable_cfg(9)
• struct arm_lpae_io_pgtable_walk_data(9)
• struct io_pgtable_ops(9)
• alloc_io_pgtable_ops(9)
• free_io_pgtable_ops(9)
• enum io_pgtable_caps(9)
• struct io_pgtable_init_fns(9)

go read them. all of them. i'll wait 🫶

---

okay that's the whole thing!! this page came from ./include/linux and it's dated October 2026 — so like, future me is already slaying with page tables 💜 bye bestie, go build something 😭✨