Commit df9cb9cc authored by Jim Mattson's avatar Jim Mattson Committed by Radim Krčmář

kvm: x86: Amend the KVM_GET_SUPPORTED_CPUID API documentation

Document the subtle nuances that KVM_CAP_X86_DISABLE_EXITS induces in
the KVM_GET_SUPPORTED_CPUID API.

Fixes: 4d5422ce ("KVM: X86: Provide a capability to disable MWAIT intercepts")
Signed-off-by: default avatarJim Mattson <jmattson@google.com>
Signed-off-by: default avatarRadim Krčmář <rkrcmar@redhat.com>
parent c1aea919
...@@ -1269,12 +1269,18 @@ struct kvm_cpuid_entry2 { ...@@ -1269,12 +1269,18 @@ struct kvm_cpuid_entry2 {
__u32 padding[3]; __u32 padding[3];
}; };
This ioctl returns x86 cpuid features which are supported by both the hardware This ioctl returns x86 cpuid features which are supported by both the
and kvm. Userspace can use the information returned by this ioctl to hardware and kvm in its default configuration. Userspace can use the
construct cpuid information (for KVM_SET_CPUID2) that is consistent with information returned by this ioctl to construct cpuid information (for
hardware, kernel, and userspace capabilities, and with user requirements (for KVM_SET_CPUID2) that is consistent with hardware, kernel, and
example, the user may wish to constrain cpuid to emulate older hardware, userspace capabilities, and with user requirements (for example, the
or for feature consistency across a cluster). user may wish to constrain cpuid to emulate older hardware, or for
feature consistency across a cluster).
Note that certain capabilities, such as KVM_CAP_X86_DISABLE_EXITS, may
expose cpuid features (e.g. MONITOR) which are not supported by kvm in
its default configuration. If userspace enables such capabilities, it
is responsible for modifying the results of this ioctl appropriately.
Userspace invokes KVM_GET_SUPPORTED_CPUID by passing a kvm_cpuid2 structure Userspace invokes KVM_GET_SUPPORTED_CPUID by passing a kvm_cpuid2 structure
with the 'nent' field indicating the number of entries in the variable-size with the 'nent' field indicating the number of entries in the variable-size
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment