vmw
vmw turns one YAML profile into a full KVM virtualization stack: a patched kernel, a patched QEMU, patched OVMF firmware, and a libvirt domain definition. Each layer changes values that guest software can read: CPUID leaves, MSR behavior, firmware tables, SMBIOS strings, and TPM identity.
The research target is VMAware, an open-source VM-detection library. Research covers which detection surfaces close, and which are inherent to nested virtualization.
Quickstart
$ git clone https://github.com/meowdiocre/vmw.git
$ cd vmw
$ pip install -e ".[dev]"
$ vmw
vmw with no arguments opens the dashboard TUI. See
Usage for the full CLI.
Layout
| Section | Covers |
|---|---|
| Usage | CLI commands, profile format, patch workflow |
| QEMU | Hypervisor CPUID bits, ACPI tables, SMBIOS |
| Firmware | OVMF build, boot logo, secure boot, identity strings |
| TPM | libtpms and swtpm identity |
| Kernel | The KVM/SVM patch: CPUID interception, MSR passthrough |
| Operations | Running profile, known gaps, useful commands |
| Manual scripts | Host/guest setup scripts vmw does not automate |
| Roadmap | Current detection status |
Status
The refactor is in progress on the refactor branch. See the
roadmap for current status.
License
GPL-3.0-or-later. See the repository.