Minki/linux
1
0
Fork 1
mirror of https://github.com/torvalds/linux.git synced 2024-11-22 12:11:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

kvm: x86: Amend the KVM_GET_SUPPORTED_CPUID API documentation

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

Fixes: 4d5422cea3 ("KVM: X86: Provide a capability to disable MWAIT intercepts")
Signed-off-by: Jim Mattson <jmattson@google.com>
Signed-off-by: Radim Krčmář <rkrcmar@redhat.com>
This commit is contained in:
Jim Mattson 2018-05-24 11:59:54 -07:00 committed by Radim Krčmář
parent c1aea9196e
commit df9cb9cc5b
1 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
Documentation/virtual/kvm/api.txt
View File

@ -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