STRUCT PAGE_POOL_PARAMS(9)

💅 struct page_pool_params(9)

okay bestie, welcome to the Kernel API Manual — yes we're reading kernel headers for fun now, this is who we are 🎀

---

✨ NAME ✨

struct page_pool_params — literally the parameters for a page pool, that's the whole vibe 💖

---

🌸 SYNOPSIS 🌸

struct page_pool_params {
    struct {
      unsigned int    order;
      unsigned int    pool_size;
      int nid;
      struct device   *dev;
      struct napi_struct *napi;
      enum dma_data_direction dma_dir;
      unsigned int    max_len;
      unsigned int    offset;
    };
    struct {
      struct net_device *netdev;
      unsigned int queue_idx;
      unsigned int    flags;
    };
 };

---

💅 Members 💅

Look at these anonymous structs, they're giving mystery ✨

• {unnamed_struct} — anonymous 🫶 (yes. that's it. that's the description. we love a no-notes king)
• order — it's 2^order pages on allocation, so like, do the math babe 🧮
• pool_size — the size of the ptr_ring ⭕
• nid — the NUMA node id we're allocating pages from 📍
• dev — the device, and it's here for DMA pre-mapping purposes 🗺️
• napi — the NAPI that is the sole consumer of pages — otherwise NULL, main character only, no sharing 🔥
• dma_dir — DMA mapping direction ➡️
• max_len — max DMA sync memory size, for PP_FLAG_DMA_SYNC_DEV 📏
• offset — DMA sync address offset, for PP_FLAG_DMA_SYNC_DEV 🎯
• {unnamed_struct} — anonymous, again 💀 (iconic behaviour honestly)
• netdev — the netdev this pool is gonna serve (leave it as NULL if there's none, or if there's multiple — yes really 👀)
• queue_idx — the queue idx this page_pool is being created for 🎟️
• flags — it's one of PP_FLAG_DMA_MAP, PP_FLAG_DMA_SYNC_DEV, PP_FLAG_SYSTEM_POOL, PP_FLAG_ALLOW_UNREADABLE_NETMEM 🚩

---

🦋 SEE ALSO 🦋

• Kernel file ./include/net/page_pool/types.h struct
• page_pool_alloc_stats(9), struct page_pool_recycle_stats(9), struct page_pool_stats(9) — go read the stats ones too bestie, iykyk 📚

---

no cap, every single field up there matters — napi being the sole consumer is not a suggestion, and netdev really does want NULL when there's none or multiple, so don't get cute 🙈

okay that's the whole page, you ate that 🍓💜

— from <pink>./include/net/page_pool</pink>, dated October 2026, with love, mwah 💋✨🌈