STRUCT MSHV_GET_SET_VP_STATE(9)

💅 struct mshv_get_set_vp_state(9) 💅

okay so this is a page from the Kernel API Manual, bestie, and it's about a little struct that carries the arguments for MSHV_[GET,SET]_VP_STATE — yes that bracket notation is doing the most but it's iconic, we love a two-for-one 🔥

---

✨ NAME ✨

struct mshv_get_set_vp_state — literally the arguments struct for MSHV_[GET,SET]_VP_STATE, no cap 🫶

---

🌸 SYNOPSIS 🌸

struct mshv_get_set_vp_state {
    __u8 type;
    __u8 rsvd[3];
    __u32 buf_sz;
    __u64 buf_ptr;
 };

that's the whole vibe. four fields. immaculate. ✨

---

🎀 MEMBERS 🎀

• type — it's MSHV_VP_STATE_*, like pick your state icon, main character energy only 💅
• rsvd — MBZ bestie. Must Be Zero. don't be quirky with this one, leave it at zero fr fr 🙈
• buf_sz — okay this one is doing double duty and it's giving overachiever:
  • in: the 4k page-aligned size of the buffer 🦋
  • out: the actual size of the data
  • and like, ngl, if you get an EINVAL, check this field to see if your buffer was too small 👀 she'll tell you
• buf_ptr — the data buffer, and yes it's 4k page-aligned too. alignment is the dress code, no exceptions 👑 ⭐

lowkey the recurring theme here is 4k page alignment — both buf_sz (the in value) and buf_ptr gotta be aligned. that's just the house rules 🎀

---

🦋 SEE ALSO 🦋

Kernel file ./include/uapi/linux/mshv.h and this whole friend group:

• struct mshv_create_partition(9)
• struct mshv_create_partition_v2(9)
• struct mshv_user_mem_region(9)
• struct mshv_gpap_access_bitmap(9)
• struct mshv_root_hvcall(9)
• struct mshv_run_vp(9)

go read them all, i'll wait 💜 (jk, read them at your own pace, you're doing amazing sweetie 🧚)

---

🌈 okay that's the whole page!! this icon lives in ./include/uapi/linux and the date on this masterpiece is October 2026 — hope that helps bestie, slay your hypervisor adventures, and remember: aligned buffers, zeroed rsvd, periodt. 💖🎀✨