hcall_create_vm(9)

🦋 hcall_create_vm — from the Kernel API Manual, bestie 💅

okay so real talk, this is a kernel API manual page for hcall_create_vm(9) and it's lowkey iconic because it does exactly one job: create a User VM. that's it, that's the whole vibe. no cap ✨

---

💖 NAME 💖

hcall_create_vm — literally just "Create a User VM", that's the entire personality 🎀

---

✨ SYNOPSIS ✨

long hcall_create_vm (u64 vminfo );

that's the function signature, keep it exactly like that, do not come for my spacing 🙈

---

🌸 ARGUMENTS 🌸

• vminfo — the Service VM GPA of the info of User VM creation 🫶 like, it's the address-y thing that points at the creation info. that's what it is. slay.

---

🔥 RETURN 🔥

• 0 on success — we love a win 💖
• <0 on failure — and if you see this, it did not eat, it flopped 😭

---

👑 SEE ALSO 👑

kernal file is ./drivers/virt/acrn/hypercall.h and bestie there is a whole friend group of these hypercalls, so let me introduce you to all of them, no skipping, we don't do that here 💅:

• hcall_sos_remove_cpu(9)
• hcall_start_vm(9)
• hcall_pause_vm(9)
• hcall_destroy_vm(9)
• hcall_reset_vm(9)
• hcall_set_vcpu_regs(9)
• hcall_inject_msi(9)
• hcall_vm_intr_monitor(9)
• hcall_set_irqline(9)
• hcall_set_ioreq_buffer(9)
• hcall_notify_req_finish(9)
• hcall_set_memory_regions(9)
• hcall_create_vdev(9)
• hcall_destroy_vdev(9)
• hcall_assign_mmiodev(9)
• hcall_deassign_mmiodev(9)
• hcall_assign_pcidev(9)
• hcall_deassign_pcidev(9)
• hcall_set_ptdev_intr(9)
• hcall_reset_ptdev_intr(9)

like, the whole squad is in ./drivers/virt/acrn/hypercall.h — go say hi 🦋

---

mwah 💜 that's the page!! this one lives in ./drivers/virt/acrn, dated October 2026, and honestly? she ate. go create some User VMs responsibly, ily, bye 🎀✨