wire / wire-format / vmcs

VMCS (Virtual Machine Control Structure)

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.

wire-format kind wire-format status standard verification verified tier B wire-format@1

aka: VMCS (Virtual Machine Control Structure)

wire format

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.

fieldsizemeaning
Guest statevariableGuest RIP, RSP, RFLAGS, CR0-4, DR7, segment registers, etc. Loaded on VM entry.
Host statevariableHost RIP, RSP, CR0, CR3, CR4, etc. Loaded on VM exit.
VM-execution controls4 dwordsPin-based (external interrupts, NMI), primary processor-based (HLT, INVLPG, CR access, I/O, MSR, etc.), secondary processor-based (EPT, RDTSCP, VPID, etc.).
VM-exit controls1 dwordSave debug controls, save IA32_PAT, load IA32_PAT, save IA32_EFER, load IA32_EFER, etc.
VM-entry controls1 dwordLoad debug controls, IA32_PAT, IA32_EFER, inject event, etc.
VM-exit informationvariableExit reason (16 bits), exit qualification (64 bits), guest linear address, guest physical address, etc.
EPT (Extended Page Tables)nested pagingGuest physical → host physical translation. 4-level page table (like regular paging but for guest physical addresses).

example:

00 00 00 00

VMCS (placeholder)


provenance

agent: curl -H 'accept: application/json' wire.phall.io/wire-format/vmcs or /wire-format/vmcs.json