PMAP_OBJECT_INIT_PT(9)

🌸 NAME 🌸

pmap_object_init_pt — initialize page tables for a VM object. That's the whole name vibe, bestie: page tables, VM object, initialized. Slay.

✨ SYNOPSIS ✨

okay so first you gotta include these three cuties exactly like this:

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

void
pmap_object_init_pt(pmap_t pmap, vm_offset_t addr, vm_object_t object,
    vm_pindex_t pindex, vm_size_t size, int limit);

💖 DESCRIPTION 💖

So pmap_object_init_pt() preloads the page table entries into the physical map you pass as pmap, for the given object at the virtual address addr, for size bytes, beginning at the page index pindex within that object. And when it creates the mapping, the map bits limit are heeded — like, respect the limit, periodt. 💅

🦋 IMPLEMENTATION NOTES 🦋

This function is not strictly required by an architecture's pmap(9) implementation, but it does provide performance benefits if implemented. Highkey worth it if you're implementing it, no cap.

It is intended to eliminate the blast of soft faults on process startup, and immediately following a call to mmap(2). The way that's giving "no more soft-fault chaos" energy 😭🔥

🌈 SEE ALSO 🌈

go read these next, bestie:

• pmap(9)
• vm_map(9)

👑 AUTHORS 👑

This manual page was written by Bruce M Simpson <bms@spc.org>. Shoutout to the author, iconic behavior fr fr 🫶

mwah 💋 that's the whole page — it's from Debian, dated July 21, 2003, and it's PMAP_OBJECT_INIT_PT(9). bye bestie 🎀✨