pmd_set_huge(9)

✨ pmd_set_huge(9) ✨

okay so we're in the Kernel API Manual bestie, and today's main character is pmd_set_huge 💅 — the little function that goes "here, have a huge PMD mapping" 🎀

---

🌸 NAME 🌸

pmd_set_huge — set up kernel PMD mapping. literally what it says on the tin, no cap 🫶

---

🦋 SYNOPSIS 🦋

int pmd_set_huge (pmd_t *pmd , phys_addr_t addr , pgprot_t prot );

three args, one int coming back at you. slay ✨

---

🎀 ARGUMENTS 🎀

• pmd — pointer to the PMD entry 🧚 this is the thing we're messing with
• addr — the virtual address associated with the PMD entry 📍
• prot — the protection bits to use 🔐 yes, these matter, don't sleep on them

---

💖 DESCRIPTION 💖

so the actual explanation? it's not even here — it says:

See text over pud_set_huge above.

like, go look at your sister function's docs, she has the whole story 👑 iykyk

returns 1 on success and 0 on failure. that's it, that's the whole vibe — no negative errno era, just a humble little 1 or 0 ⭐

---

🌈 SEE ALSO 🌈

• Kernel file ./arch/x86/mm/pgtable.c reserve_top_address(9)
• p4d_set_huge(9)
• p4d_clear_huge(9)
• pud_set_huge(9)
• pud_clear_huge(9)
• pmd_clear_huge(9) (the one who undoes all this 😭)
• pmd_free_pte_page(9)

the whole huge-page friend group fr fr 💜

---

and that's the page!! brought to you by the files in ./arch/x86/mm, dated October 2026 — mwah, go touch some page tables bestie 💅💖