PMAP_UNWIRE(9)

💖 PMAP_UNWIRE 💖

okay bestie, so this is the man page for pmap_unwire — it's a <pink>Kernel Developer's Manual</pink> moment, from section 9 of the manual (that's the kernel interface girlies, iykyk). Buckle up, it's giving low-level memory magic ✨

🌸 NAME 🌸

pmap_unwire — unwire a range of virtual pages 🪄

🎀 SYNOPSIS 🎀

#include <sys/param.h>
#include <vm/vm.h>
#include <vm/pmap.h>

void
pmap_unwire(pmap_t pmap, vm_offset_t start, vm_offset_t end);

yes bestie, those three includes are non-negotiable, copy them exactly fr fr 📋

✨ DESCRIPTION ✨

So the function pmap_unwire() does exactly what it says on the tin: it removes the wired attribute from each and every one of the virtual-to-physical page mappings inside the virtual address range that runs from start to end of the physical map pmap. 💅

Now here's the tea ☕ — every valid mapping within that range is REQUIRED to have the wired attribute set. Like, that's the deal. That's the contract.

Invalid mappings? Those get ignored, no cap 🙈 — because they literally cannot have the wired attribute set in the first place. Not our problem, not our business.

🦋 NOTES 🦋

Heads up bestie: the only function that can set the wired attribute of a virtual-to-physical page mapping is pmap_enter(9). That's the one and only. The way that it's the exclusive vibe-setter here... iconic 👑

🌈 SEE ALSO 🌈

• pmap(9)
• pmap_enter(9)
• pmap_wired_count(9)

go read those too, they're all part of the same friend group 🫶

💜 AUTHORS 💜

This manual page was written by Alan L. Cox <alc@rice.edu>. slay, thank you for your service king 🫡✨

and that's a wrap bestie!! this page came to you from the Debian edition of the manual, dated July 17, 2014 🎂 no cap, go unwire some pages responsibly 💖🌸🎀