mshv_region_process_range(9)

💅 mshv_region_process_range(9)

okay so welcome to the Kernel API Manual, bestie 🫶 — today's main character is mshv_region_process_range(9), and honestly? she's giving ✨*plumbing*✨ in the best way possible.

---

✨ NAME ✨

mshv_region_process_range — processes a range of memory pages in a region. that's it, that's the vibe 💖

---

🌸 SYNOPSIS 🌸

int mshv_region_process_range (struct mshv_mem_region *region , u32
flags , u64 page_offset , u64 page_count , int (*handler)(struct
mshv_mem_region *region, u32 flags, u64 page_offset, u64 page_count,
bool huge_page) );

---

🎀 ARGUMENTS 🎀

• region — pointer to the memory region structure. the whole girl. the region in question 💅
• flags — flags to pass to the handler. you don't interpret them here, you just hand them over, like a good friend 🫶
• page_offset — offset into the region's pages array to start processing. where we begin the scroll 😌
• page_count — number of pages to process. how many we're doing. no cap.
• handler — callback function to handle each chunk of contiguous pages. this one's the VIP, she does the actual work 👑

---

🦋 DESCRIPTION 🦋

so what actually happens? she iterates over the specified range of pages in region, skipping non-present pages — like, not invited, not going 💀 — and then for each contiguous chunk of present pages, she invokes handler via mshv_region_process_chunk. literally the group-chat organizer of kernel functions, splitting everyone into the right little clusters 🔥

---

⭐ NOTE ⭐

heads up bestie, this one matters: the handler callback must be able to handle both normal and huge pages. no exceptions, no "I forgot", no "I didn't read the message" 🙈

and the return situation: returns 0 on success, or a negative error code on failure. slay when it's 0, sad girl hours when it's negative 😭

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/hv/mshv_regions.c — go read the source, iykyk 📖
• mshv_chunk_stride(9)
• mshv_region_process_chunk(9)
• mshv_region_range_fault(9)
• mshv_region_interval_invalidate(9)

---

and that's the page, babe 💜 — brought to you by the fine folks over in ./drivers/hv, dated October 2026, and yes the footer still says mshv_region_process_range(9) because we keep the branding consistent, periodt ✨🎀🧚