STRUCT MSHV_GPAP_ACCESS_BITMAP(9)

✨ struct mshv_gpap_access_bitmap(9) — Kernel API Manual ✨

okay bestie, welcome to the struct mshv_gpap_access_bitmap(9) page 💅 this is the kernel API manual, and we're gonna get you so comfy with this lil struct. it's giving "small but important", fr fr 🫶

---

🌸 NAME 🌸

struct mshv_gpap_access_bitmap — the arguments you pass for MSHV_GET_GPAP_ACCESS_BITMAP ✨ like, that's literally its whole job and it ate 💖

---

🎀 SYNOPSIS 🎀

struct mshv_gpap_access_bitmap {
    __u8 access_type;
    __u8 access_op;
    __u8 rsvd[6];
    __u64 page_count;
    __u64 gpap_base;
    __u64 bitmap_ptr;
 };

look at her. iconic. no cap 👑

---

🦋 Members 🦋

okay so let's meet the cast, one field at a time 💜

• access_type — MSHV_GPAP_ACCESS_TYPE_*. this tells the kernel which kind of access you want recorded in the bitmap. pick your type, bestie 🌈
• access_op — MSHV_GPAP_ACCESS_OP_*. this one's the optional flex: after it retrieves all the current access states for the range, it lets you clear or set all of them. cute little bonus move ✨
• rsvd — MBZ, aka "must be zero". do not touch, do not decorate, just zero it 🙈
• page_count — the number of pages. that's it, that's the field 💅
• gpap_base — the base gpa page number. the starting point, the main character of the address range 👑
• bitmap_ptr — the output buffer for the bitmap, and it needs to be at least (page_count + 7) / 8 bytes. do the math, give it room, let it breathe 🍓

---

⭐ Description ⭐

so what does this thing actually do? it retrieves a bitmap of either the ACCESSED or the DIRTY bits — whichever one you asked for with access_type — for a given range of guest memory 💖 and as a lil optional treat, it can also clear or set those bits for you. obsessed 😭

---

🔥 SEE ALSO 🔥

• Kernel file ./include/uapi/linux/mshv.h
• struct mshv_create_partition(9)
• struct mshv_create_partition_v2(9)
• struct mshv_user_mem_region(9)
• struct mshv_root_hvcall(9)
• struct mshv_run_vp(9)
• struct mshv_get_set_vp_state(9)

go read those next, iykyk 📚💅

---

and that's the whole page, bestie 🧚 this came from ./include/uapi/linux, dated October 2026, and it's filed under struct mshv_...ccess_bitmap(9) — periodt 💖✨🎀