FreeBSD Status Report
Report Entry
Full CPUID Control for bhyve
Contact: Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org>
Project Overview
Ongoing work on this project aims to integrate the existing proof-of-concept work into FreeBSD, and to add the following usability features:
-
a user-friendly configuration method to override individual bits, parts or even whole CPUID functions as needed, while keeping the rest of the host CPUID information or a pre-defined CPUID configuration
-
a user-friendly configuration method for the hypervisor signature reported by bhyve
-
a set of predefined CPUID configurations based on common x86 architecture levels, perhaps also including a set of CPUID data for a few real CPU models, and a user-friendly configuration method to choose one for a VM
Changes during the last quarter
Changes to the bhyve configuration syntax
There was a last minute change to the configuration syntax.
Instead of using two different options cpuid.enable and cpuid.disable to enable or disable features by name, there is now a single cpuid.features option.
This option accepts feature name, either prefixed with - to disable them, or prefixed with + or no prefix to enable a feature.
Pre-defined CPU Models
In addition to the abstract x86 architecture models, a number of CPU models have been implemented as pre-defined configuration file snippets. This currently ends with the Icelake generation for Intel and the Bulldozer generation for AMD.
Many more cpuid configuration options have been introduced to ease writing of CPU model configurations, such as cpuid.brand for the CPU Brand String or cpuid.vendor to override the vendor identification.
CPUID Constraints checks
The constraints checks have been extended to allow defining bitmasks for values that can only be numerically lowered.
A new configuration option cpuid.check has been introduced to override the default action regarding the constraints checks.
It takes the values fail (the default), warn, none, and fix.
Cache Configuration
Default cache configurations have been added to the x86 architecture models and all pre-defined CPU models.
Hypervisor Identification
A new cpuid.hypervisor option allows easy overriding of the hypervisor identification in CPUID function 0x40000000.
The real hypervisor identification and feature flags can still be queried by guests from CPUID function 0x40000100.
Plans for the next quarter
-
Add more modern pre-defined CPU models
-
Update manpages bhyve(8), bhyve_config(5), and bhyvectl(8).
-
Get the whole wad reviewed and committed into FreeBSD.
Last modified on: October 6, 2026 by Hans Rosenfeld