hcall_assign_pcidev(9)

✨ hcall_assign_pcidev — Kernel API Manual, section 9 ✨

Okay so bestie, welcome to the glow-up of hcall_assign_pcidev(9) 💅 — it's a page straight out of the Kernel API Manual, and it's literally about handing a whole PCI device over to a User VM. Main character hypercall energy, no cap.

---

🎀 NAME 🎀

hcall_assign_pcidev — assign a PCI device to a User VM 🫶

---

✨ SYNOPSIS ✨

long hcall_assign_pcidev (u64 vmid , u64 addr );

That's it. Two args, one long. Iconic. 🌸

---

🦋 ARGUMENTS 🦋

• vmid — the User VM ID 🏷️ — like, which User VM are we doing this for, bestie?
• addr — the Service VM GPA of the struct acrn_pcidev 📍 — yes, a guest physical address pointing at that struct, she's fancy like that.

---

⭐ RETURN ⭐

• 0 on success 🎉
• <0 on failure 😭 (not her best moment, but ok)

---

👑 SEE ALSO 👑

Kernel file ./drivers/virt/acrn/hypercall.h — and honestly the whole hypercall friend group showed up, so let's give them their moment 💖:

• 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_destroy_vdev(9)
• hcall_assign_mmiodev(9)
• hcall_deassign_mmiodev(9)
• hcall_deassign_pcidev(9)
• hcall_set_ptdev_intr(9)
• hcall_reset_ptdev_intr(9)

ngl, hcall_deassign_pcidev(9) is literally this one's other half — assign her, deassign her, the circle of life 🦋

---

and that's the whole page, bestie — go assign some PCI devices, slay 💅✨

Comin' at you from ./drivers/virt/acrn, dated October 2026 — hcall_assign_pcidev(9), signing off 🎀💜