STRUCT ACRN_VM(9)

💜 struct_acrn_vm(9) — like, the whole vibe of an ACRN User VM

okay so bestie, welcome to the Kernel API Manual ✨ this is the page for struct acrn_vm, which is literally the receipt for what makes an ACRN User VM a User VM. every field, every lock, every list — it's all here, no cap. 🫶

---

🌸 NAME 🌸

struct acrn_vm — Properties of ACRN User VM. that's it, that's the whole name section, she's short and she knows it 💅

---

🦋 SYNOPSIS 🦋

here's the actual struct, copied character for character because we do NOT play with code in this house:

struct acrn_vm {
    struct list_head                list;
    u16 vmid;
    int vcpu_num;
    unsigned long                   flags;
    struct mutex                    regions_mapping_lock;
    struct vm_memory_mapping
regions_mapping[ACRN_MEM_MAPPING_MAX];
    int regions_mapping_count;
    spinlock_t ioreq_clients_lock;
    struct list_head                ioreq_clients;
    struct acrn_ioreq_client        *default_client;
    struct acrn_io_request_buffer   *ioreq_buf;
    struct page                     *ioreq_page;
    u32 pci_conf_addr;
    struct page                     *monitor_page;
    struct mutex                    ioeventfds_lock;
    struct list_head                ioeventfds;
    struct acrn_ioreq_client        *ioeventfd_client;
    struct mutex                    irqfds_lock;
    struct list_head                irqfds;
    struct workqueue_struct         *irqfd_wq;
 };

(and yes, that one member decl is split across two lines in the original and we are keeping it, okay, respect the source 🎀)

---

👑 Members 👑

this is the main character energy section. every single field, in order, no skips:

• list — her entry within the global list of all VMs. she's on the list, she's iconic, she's tracked. 📋
• vmid — User VM ID. the name tag at the party. 💖
• vcpu_num — number of virtual CPUs in the VM. how many lil workers she's got. 🔥
• flags — flags (ACRN_VM_FLAG_*) of the VM. important lore: this is VM flag management in HSM, and it's different from the acrn_vm_creation.vm_flag. do not confuse them, bestie, they are not the same thing, fr fr. 🙈
• regions_mapping_lock — the lock protecting acrn_vm.regions_mapping and acrn_vm.regions_mapping_count. bodyguard behavior. 🛡️ (ok there's no shield emoji in the allowed list but the vibe stands)
• regions_mapping — memory mappings of this VM. the map of her territory 🌈
• regions_mapping_count — number of memory mappings of this VM. literally just the count, keeping the map honest 🧮
• ioreq_clients_lock — lock to protect ioreq_clients and default_client. another bodyguard, different ward 💅
• ioreq_clients — the I/O request clients list of this VM. the group chat of I/O clients, lowkey 🫶
• default_client — the default I/O request client. when nobody else gets picked, she does 🌟
• ioreq_buf — I/O request shared buffer. the shared snack table, everyone's welcome 🍓
• ioreq_page — the page of the I/O request shared buffer. the physical page that holds the above 💜
• pci_conf_addr — address of a PCI configuration access emulation. (the original says "Address of a PCI configuration access emulation" and we are saying it exactly, no edits 😭)
• monitor_page — page of interrupt statistics of User VM. stats page, she's the analytics dashboard 📊
• ioeventfds_lock — lock to protect the ioeventfds list. 🔒
• ioeventfds — list to link all hsm_ioeventfd. all of them. linked. chain gang ⛓️ (cute chain gang though)
• ioeventfd_client — I/O client for ioeventfds of the VM. she handles the ioeventfds business specifically ✨
• irqfds_lock — lock to protect the irqfds list. yes, another lock, we have so many locks, it's giving secure 😌
• irqfds — list to link all hsm_irqfd. same energy, different list 💫
• irqfd_wq — workqueue for irqfd async shutdown. the cleanup crew, doing it asynchronously, slay 🌙

---

🔍 SEE ALSO 🔍

go read these too, iykyk, they're all connected:

• Kernel file ./drivers/virt/acrn/acrn_drv.h
• struct vm_memory_region_op(9)
• struct vm_memory_region_batch(9)
• struct vm_memory_mapping(9)
• struct acrn_ioreq_buffer(9)
• struct acrn_ioreq_client(9)

---

that's the page bestie, you ate it up 💅✨ a big sparkly thank you to ./drivers/virt/acrn for the source, dated October 2026, and this manual page will forever be known as struct acrn_vm(9) 🎀🦋💖