hcall_destroy_vdev(9)

💅 hcall_destroy_vdev — a kernel API manual situation

Okay so bestie, welcome to the Kernel API Manual entry for hcall_destroy_vdev(9) — yes that (9) is the section, we're in kernel-API land, put your seatbelt on. 🎀

---

🌸 NAME 🌸

hcall_destroy_vdev — literally the hypercall that destroys a virtual device of a User VM. That's the whole vibe. Poof, gone, bye. ✨

---

🦋 SYNOPSIS 🦋

long hcall_destroy_vdev (u64 vmid , u64 addr );

That's it, that's the signature. Two u64 args, returns a long. Copy it exactly, don't get cute with the spacing — it's giving "committed to the bit" and we respect it. 💅

---

🎀 ARGUMENTS 🎀

• vmid — the User VM ID. Like, which VM are we talking about here. The main character VM. 👑
• addr — the Service VM GPA of the struct acrn_vdev. Which is a whole way of saying "the address, from the Service VM's point of view, where that vdev struct lives." Not a vibe check, an address check. 🫶

---

⭐ RETURN ⭐

• 0 on success — slay, the device is destroyed 💖
• <0 on failure — not slay, something went sideways 😭

That's the whole return contract, no cap. No extra codes, no gray areas, just 0 or negative. Periodt.

---

🌈 SEE ALSO 🌈

Okay this list is long and honestly iconic, so buckle up. First the source file, then the whole hypercall friendship group:

Kernel file ./drivers/virt/acrn/hypercall.h, plus:

• hcall_sos_remove_cpu(9)
• hcall_create_vm(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_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)

That's twenty entries bestie, twenty. Go read them, iykyk. 📚✨

Also lowkey note: hcall_create_vdev(9) is right there in the list, so if you're out here destroying vdevs, you probably want to know how they got created in the first place. Symmetry, queen. 🦋

---

💖 and that's the page! shipped from ./drivers/virt/acrn, dated October 2026, and it's hcall_destroy_vdev(9) forever and always. bye bestie, go destroy some virtual devices responsibly 💖