wire / wire-format / vmcs
The VMCS is the data structure used by Intel VT-x to control a virtual machine. It contains: guest state (registers, RIP, RSP, CR0-4, etc.), host state (registers to restore on VM exit), VM-execution controls (which events cause VM exits), VM-exit controls (what to save on exit), VM-entry controls (what to load on entry), and VM-exit information (reason, qualification). The VMCS is 4KB, accessed via VMREAD/VMWRITE instructions.
aka: VMCS (Virtual Machine Control Structure)
spec: Intel VT-x
The VMCS is the data structure used by Intel VT-x to control a virtual machine. It contains: guest state (registers, RIP, RSP, CR0-4, etc.), host state (registers to restore on VM exit), VM-execution controls (which events cause VM exits), VM-exit controls (what to save on exit), VM-entry controls (what to load on entry), and VM-exit information (reason, qualification). The VMCS is 4KB, accessed via VMREAD/VMWRITE instructions.
| field | size | meaning |
|---|---|---|
| Guest state | variable | Guest RIP, RSP, RFLAGS, CR0-4, DR7, segment registers, etc. Loaded on VM entry. |
| Host state | variable | Host RIP, RSP, CR0, CR3, CR4, etc. Loaded on VM exit. |
| VM-execution controls | 4 dwords | Pin-based (external interrupts, NMI), primary processor-based (HLT, INVLPG, CR access, I/O, MSR, etc.), secondary processor-based (EPT, RDTSCP, VPID, etc.). |
| VM-exit controls | 1 dword | Save debug controls, save IA32_PAT, load IA32_PAT, save IA32_EFER, load IA32_EFER, etc. |
| VM-entry controls | 1 dword | Load debug controls, IA32_PAT, IA32_EFER, inject event, etc. |
| VM-exit information | variable | Exit reason (16 bits), exit qualification (64 bits), guest linear address, guest physical address, etc. |
| EPT (Extended Page Tables) | nested paging | Guest physical → host physical translation. 4-level page table (like regular paging but for guest physical addresses). |
example:
00 00 00 00
VMCS (placeholder)
agent: curl -H 'accept: application/json' wire.phall.io/wire-format/vmcs
or /wire-format/vmcs.json