KVM: x86: Make bus clock frequency for vAPIC timer configurable
Subsystems (6)
v6 cover KVM: x86: Make bus clock frequency for vAPIC timer configurable
Changes from v5:
- v5: https://lore.kernel.org/lkml/[email protected]/
- Rebased on latest of "next" branch of https://github.com/kvm-x86/linux.git
- Added Xiaoyao Li and Yuan Yao's Reviewed-by tags.
- Use the KVM selftest vm_create() wrapper instead of open coding it. (Zide)
- Improve grammar of selftest description. (Zide)
Changes from v4:
- v4: https://lore.kernel.org/lkml/[email protected]/
- Rename capability from KVM_CAP_X86_APIC_BUS_FREQUENCY to KVM_CAP_X86_APIC_BUS_CYCLES_NS. (Xiaoyao Li).
- Include "Testing" section in cover letter.
- Add Rick's Reviewed-by tags.
- Rebased on latest of "next" branch of https://github.com/kvm-x86/linux.git
Changes from v3:
- v3: https://lore.kernel.org/all/[email protected]/
- Reworked all changelogs.
- Regarding code changes: patches #1 and #2 are unchanged, patch #3 was reworked according to Sean's guidance, and patch #4 (the test) needed changes after rebase to kvm-x86/next and the implementation (patch #3) changes.
- Added Reviewed-by tags to patches #1, #2, and #4, but removed Maxim's Reviewed-by tag from patch #3 because it changed so much.
- Added a "Suggested-by" to patch #4 to reflect that it represents Sean's guidance.
- Reworked cover to match customs (in subject line) and reflect feedback to patches: capability renamed to KVM_CAP_X86_APIC_BUS_FREQUENCY, clarify distinction between "core crystal clock" and "bus clock", and update pro/con list.
- Please refer to individual patches for detailed changes.
Changes from v2:
- v2: https://lore.kernel.org/lkml/[email protected]/
- Removed APIC_BUS_FREQUENCY and apic_bus_frequency of struct kvm-arch.
- Update the commit messages.
- Added reviewed-by (Maxim Levitsky)
- Use 1.5GHz instead of 1GHz as frequency for the test case.
Changes from v1:
- v1: https://lore.kernel.org/all/[email protected]/
- Added a test case
- Fix a build error for i386 platform
- Add check if vcpu isn't created.
- Add check if lapic chip is in-kernel emulation.
- Updated api.rst
Summary
-------
Add KVM_CAP_X86_APIC_BUS_CYCLES_NS capability to configure the APIC bus clock frequency for APIC timer emulation.
Allow KVM_ENABLE_CAPABILITY(KVM_CAP_X86_APIC_BUS_CYCLES_NS) to set the frequency in nanoseconds. When using this capability, the user space VMM should configure CPUID leaf 0x15 to advertise the frequency.
Description
-----------
Vishal reported [1] that the TDX guest kernel expects a 25MHz APIC bus frequency but ends up getting interrupts at a significantly higher rate.
The TDX architecture hard-codes the core crystal clock frequency to 25MHz and mandates exposing it via CPUID leaf 0x15. The TDX architecture does not allow the VMM to override the value.
In addition, per Intel SDM:
"The APIC timer frequency will be the processor’s bus clock or core
crystal clock frequency (when TSC/core crystal clock ratio is enumerated in CPUID leaf 0x15) divided by the value specified in the divide configuration register."
The resulting 25MHz APIC bus frequency conflicts with the KVM hardcoded APIC bus frequency of 1GHz.
The KVM doesn't enumerate CPUID leaf 0x15 to the guest unless the user space VMM sets it using KVM_SET_CPUID. If the CPUID leaf 0x15 is enumerated, the guest kernel uses it as the APIC bus frequency. If not, the guest kernel measures the frequency based on other known timers like the ACPI timer or the legacy PIT. As reported in [1] the TDX guest kernel expects a 25MHz timer frequency but gets timer interrupt more frequently due to the 1GHz frequency used by KVM.
To ensure that the guest doesn't have a conflicting view of the APIC bus frequency, allow the userspace to tell KVM to use the same frequency that TDX mandates instead of the default 1Ghz.
There are several options to address this:
1. Make the KVM able to configure APIC bus frequency (this series).
Pro: It resembles the existing hardware. The recent Intel CPUs
adopts 25MHz.
Con: Require the VMM to emulate the APIC timer at 25MHz.
2. Make the TDX architecture enumerate CPUID leaf 0x15 to configurable frequency or not enumerate it.
Pro: Any APIC bus frequency is allowed.
Con: Deviates from TDX architecture.
3. Make the TDX guest kernel use 1GHz when it's running on KVM.
Con: The kernel ignores CPUID leaf 0x15.
4. Change CPUID leaf 0x15 under TDX to report the crystal clock frequency as 1 GHz.
Pro: This has been the virtual APIC frequency for KVM guests for 13
years.
Pro: This requires changing only one hard-coded constant in TDX.
Con: It doesn't work with other VMMs as TDX isn't specific to KVM.
Con: Core crystal clock frequency is also used to calculate TSC frequency.
Con: If it is configured to value different from hardware, it will
break the correctness of INTEL-PT Mini Time Count (MTC) packets in TDs.
Testing
-------
Tested on non-TDX host using included kselftest. Host running kernel with this series applied to "next" branch of
https://github.com/kvm-x86/linux.git
Tested on TDX host and TD using a modified version
of x86/apic.c:test_apic_timer_one_shot() available from
https://github.com/intel/kvm-unit-tests-tdx/blob/tdx/x86/apic.c.
Host running TDX KVM development patches and QEMU with corresponding TDX changes.
The test needed to be modified to (a) stop any lingering timers before the test starts, and (b) use CPUID 0x15 in TDX to accurately determine the TSC and APIC frequencies instead of making 1GHz assumption and use similar check as the kselftest test introduced in this series (while increasing the amount with which the frequency is allowed to deviate by 1%).
The core changes made to x86/apic.c:test_apic_timer_one_shot() for this testing are shown below for reference. Work is in progress to upstream these modifications.
@@ -477,11 +478,29 @@ static void lvtt_handler(isr_regs_t *regs)
static void test_apic_timer_one_shot(void)
{
- uint64_t tsc1, tsc2;
static const uint32_t interval = 0x10000;
+ uint64_t measured_apic_freq, tsc2, tsc1;
+ uint32_t tsc_freq = 0, apic_freq = 0;
+ struct cpuid cpuid_tsc = {};
#define APIC_LVT_TIMER_VECTOR (0xee)
+ /*
+ * CPUID 0x15 is not available in VMX, can use it to obtain
+ * TSC and APIC frequency for accurate testing
+ */
+ if (is_tdx_guest()) {
+ cpuid_tsc = raw_cpuid(0x15, 0);
+ tsc_freq = cpuid_tsc.c * cpuid_tsc.b / cpuid_tsc.a;
+ apic_freq = cpuid_tsc.c;
+ }
+ /*
+ stop already fired local timer + the test case can be negative failure if the timer fired + after installed lvtt_handler but *before* + write to TIMICT again.
+ */
+ apic_write(APIC_TMICT, 0);
handle_irq(APIC_LVT_TIMER_VECTOR, lvtt_handler);
/* One shot mode */
@@ -503,8 +522,16 @@ static void test_apic_timer_one_shot(void)
* cases, the following should satisfy on all modern
* processors.
*/
- report((lvtt_counter == 1) && (tsc2 - tsc1 >= interval),
- "APIC LVT timer one shot");
+ if (is_tdx_guest()) {
+ measured_apic_freq = interval * (tsc_freq / (tsc2 - tsc1));
+ report((lvtt_counter == 1) &&
+ (measured_apic_freq < apic_freq * 102 / 100) && + (measured_apic_freq > apic_freq * 98 / 100), + "APIC LVT timer one shot");
+ } else {
+ report((lvtt_counter == 1) && (tsc2 - tsc1 >= interval),
+ "APIC LVT timer one shot");
+ }
}
[1] https://lore.kernel.org/lkml/[email protected]/
Isaku Yamahata (4):
KVM: x86: hyper-v: Calculate APIC bus frequency for Hyper-V
KVM: x86: Make nsec per APIC bus cycle a VM variable
KVM: x86: Add a capability to configure bus frequency for APIC timer
KVM: selftests: Add test for configure of x86 APIC bus frequency
Documentation/virt/kvm/api.rst | 17 ++ arch/x86/include/asm/kvm_host.h | 1 + arch/x86/kvm/hyperv.c | 3 +- arch/x86/kvm/lapic.c | 6 +- arch/x86/kvm/lapic.h | 3 +- arch/x86/kvm/x86.c | 28 +++ include/uapi/linux/kvm.h | 1 + tools/testing/selftests/kvm/Makefile | 1 + .../selftests/kvm/include/x86_64/apic.h | 7 + .../kvm/x86_64/apic_bus_clock_test.c | 166 ++++++++++++++++++ 10 files changed, 228 insertions(+), 5 deletions(-) create mode 100644 tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c
base-commit: d91a9cc16417b8247213a0144a1f0fd61dc855dd
Signature · 1 line
2.34.1
PATCH v6 1/4 KVM: x86: hyper-v: Calculate APIC bus frequency for Hyper-V
From: Isaku Yamahata <[email protected]>
Remove APIC_BUS_FREQUENCY and calculate it based on nanoseconds per APIC bus cycle. APIC_BUS_FREQUENCY is used only for HV_X64_MSR_APIC_FREQUENCY. The MSR is not frequently read, calculate it every time.
There are two constants related to the APIC bus frequency:APIC_BUS_FREQUENCY and APIC_BUS_CYCLE_NS.
Only one value is required because one can be calculated from the other:
APIC_BUS_CYCLES_NS = 1000 * 1000 * 1000 / APIC_BUS_FREQUENCY.
Remove APIC_BUS_FREQUENCY and instead calculate it when needed. This prepares for support of configurable APIC bus frequency by requiring to change only a single variable.
---
Changes v5:
- Add Rick's Reviewed-by tag.
Changes v4:
- Modify subject to match custom: "KVM: x86/hyperv:" -> "KVM: x86: hyper-v:" and use standard capitalization for Hyper-V ("hyper-v" -> "Hyper-V").
- Rework changelog to remove pronouns ("we").
- Change logic in commit log: "APIC bus cycles per NS" -> "nanoseconds per APIC bus cycle".
- Fix typos. (Maxim and Xiaoyao)
- Add Maxim and Xiaoyao's Reviewed-by tags.
- Add Maxim's "Suggested-by".
Changes v3:
- Newly added according to Maxim Levitsky suggestion.
--- arch/x86/kvm/hyperv.c | 2 +- arch/x86/kvm/lapic.h | 1 - 2 files changed, 1 insertion(+), 2 deletions(-)
arch/x86/kvm/hyperv.c +1 -1
@@ -1737,7 +1737,7 @@ static int kvm_hv_get_msr(struct kvm_vcpu *vcpu, u32 msr, u64 *pdata, data = (u64 )vcpu->arch.virtual_tsc_khz *1000 ;break ;case HV_X64_MSR_APIC_FREQUENCY : - data =APIC_BUS_FREQUENCY ; + data =div64_u64 (1000000000ULL ,APIC_BUS_CYCLE_NS );break ;default :kvm_pr_unimpl_rdmsr (vcpu, msr);
arch/x86/kvm/lapic.h +0 -1
@@ -17,7 +17,6 @@#define APIC_DEST_MASK 0x800#define APIC_BUS_CYCLE_NS 1 -#define APIC_BUS_FREQUENCY (1000000000ULL / APIC_BUS_CYCLE_NS)#define APIC_BROADCAST 0xFF#define X2APIC_BROADCAST 0xFFFFFFFFul
Signature · 1 line
2.34.1
PATCH v6 2/4 KVM: x86: Make nsec per APIC bus cycle a VM variable
In reply to Reinette ChatreFrom: Isaku Yamahata <[email protected]>
Introduce the VM variable "nanoseconds per APIC bus cycle" in preparation to make the APIC bus frequency configurable.
The TDX architecture hard-codes the core crystal clock frequency to 25MHz and mandates exposing it via CPUID leaf 0x15. The TDX architecture does not allow the VMM to override the value.
In addition, per Intel SDM:
"The APIC timer frequency will be the processor’s bus clock or core
crystal clock frequency (when TSC/core crystal clock ratio is enumerated in CPUID leaf 0x15) divided by the value specified in the divide configuration register."
The resulting 25MHz APIC bus frequency conflicts with the KVM hardcoded APIC bus frequency of 1GHz.
Introduce the VM variable "nanoseconds per APIC bus cycle" to prepare for allowing userspace to tell KVM to use the frequency that TDX mandates instead of the default 1Ghz. Doing so ensures that the guest doesn't have a conflicting view of the APIC bus frequency.
---
Changes v6:
- Add Xiaoyao Li's Reviewed-by tag.
Changes v5:
- Add Rick's Reviewed-by tag.
Changes v4:
- Reword changelog to address comments related to "bus clock" vs "core crystal clock" frequency. (Xiaoyao)
- Typo in changelog ("APIC APIC" -> "APIC").
- Change logic "APIC bus cycles per nsec" -> "nanoseconds per APIC bus cycle".
Changes V3:
- Update commit message.
- Dropped apic_bus_frequency according to Maxim Levitsky.
Changes v2:
- No change.
--- arch/x86/include/asm/kvm_host.h | 1 + arch/x86/kvm/hyperv.c | 3 ++- arch/x86/kvm/lapic.c | 6 ++++-- arch/x86/kvm/lapic.h | 2 +- arch/x86/kvm/x86.c | 1 + 5 files changed, 9 insertions(+), 4 deletions(-)
arch/x86/include/asm/kvm_host.h +1 -0
@@ -1358,6 +1358,7 @@ struct kvm_arch {u32 default_tsc_khz;bool user_set_tsc; +u64 apic_bus_cycle_ns;seqcount_raw_spinlock_t pvclock_sc;bool use_master_clock;
arch/x86/kvm/hyperv.c +2 -1
@@ -1737,7 +1737,8 @@ static int kvm_hv_get_msr(struct kvm_vcpu *vcpu, u32 msr, u64 *pdata, data = (u64 )vcpu->arch.virtual_tsc_khz *1000 ;break ;case HV_X64_MSR_APIC_FREQUENCY : - data =div64_u64 (1000000000ULL ,APIC_BUS_CYCLE_NS ); + data =div64_u64 (1000000000ULL , + vcpu->kvm->arch.apic_bus_cycle_ns);break ;default :kvm_pr_unimpl_rdmsr (vcpu, msr);
arch/x86/kvm/lapic.c +4 -2
@@ -1547,7 +1547,8 @@ static u32 apic_get_tmcct(struct kvm_lapic *apic) remaining =0 ; ns =mod_64 (ktime_to_ns (remaining), apic->lapic_timer.period); -return div64_u64 (ns, (APIC_BUS_CYCLE_NS * apic->divide_count)); +return div64_u64 (ns, (apic->vcpu->kvm->arch.apic_bus_cycle_ns * + apic->divide_count)); }static void __report_tpr_access (struct kvm_lapic *apic,bool write)
@@ -1965,7 +1966,8 @@ static void start_sw_tscdeadline(struct kvm_lapic *apic)static inline u64 tmict_to_ns (struct kvm_lapic *apic,u32 tmict) { -return (u64 )tmict *APIC_BUS_CYCLE_NS * (u64 )apic->divide_count; +return (u64 )tmict * apic->vcpu->kvm->arch.apic_bus_cycle_ns * + (u64 )apic->divide_count; }static void update_target_expiration (struct kvm_lapic *apic,uint32_t old_divisor)
arch/x86/kvm/lapic.h +1 -1
@@ -16,7 +16,7 @@#define APIC_DEST_NOSHORT 0x0#define APIC_DEST_MASK 0x800 -#define APIC_BUS_CYCLE_NS 1 +#define APIC_BUS_CYCLE_NS_DEFAULT 1#define APIC_BROADCAST 0xFF#define X2APIC_BROADCAST 0xFFFFFFFFul
arch/x86/kvm/x86.c +1 -0
@@ -12623,6 +12623,7 @@ int kvm_arch_init_vm(struct kvm *kvm, unsigned long type)raw_spin_unlock_irqrestore (&kvm->arch.tsc_write_lock, flags); kvm->arch.default_tsc_khz = max_tsc_khz ? : tsc_khz; + kvm->arch.apic_bus_cycle_ns =APIC_BUS_CYCLE_NS_DEFAULT ; kvm->arch.guest_can_read_msr_platform_info = true; kvm->arch.enable_pmu = enable_pmu;
Signature · 1 line
2.34.1
PATCH v6 3/4 KVM: x86: Add a capability to configure bus frequency for APIC timer
In reply to Reinette ChatreFrom: Isaku Yamahata <[email protected]>
Add KVM_CAP_X86_APIC_BUS_CYCLES_NS capability to configure the APIC bus clock frequency for APIC timer emulation.
Allow KVM_ENABLE_CAPABILITY(KVM_CAP_X86_APIC_BUS_CYCLES_NS) to set the frequency in nanoseconds. When using this capability, the user space VMM should configure CPUID leaf 0x15 to advertise the frequency.
Vishal reported that the TDX guest kernel expects a 25MHz APIC bus frequency but ends up getting interrupts at a significantly higher rate.
The TDX architecture hard-codes the core crystal clock frequency to 25MHz and mandates exposing it via CPUID leaf 0x15. The TDX architecture does not allow the VMM to override the value.
In addition, per Intel SDM:
"The APIC timer frequency will be the processor’s bus clock or core
crystal clock frequency (when TSC/core crystal clock ratio is enumerated in CPUID leaf 0x15) divided by the value specified in the divide configuration register."
The resulting 25MHz APIC bus frequency conflicts with the KVM hardcoded APIC bus frequency of 1GHz.
The KVM doesn't enumerate CPUID leaf 0x15 to the guest unless the user space VMM sets it using KVM_SET_CPUID. If the CPUID leaf 0x15 is enumerated, the guest kernel uses it as the APIC bus frequency. If not, the guest kernel measures the frequency based on other known timers like the ACPI timer or the legacy PIT. As reported by Vishal the TDX guest kernel expects a 25MHz timer frequency but gets timer interrupt more frequently due to the 1GHz frequency used by KVM.
To ensure that the guest doesn't have a conflicting view of the APIC bus frequency, allow the userspace to tell KVM to use the same frequency that TDX mandates instead of the default 1Ghz.
There are several options to address this:
1. Make the KVM able to configure APIC bus frequency (this series).
Pro: It resembles the existing hardware. The recent Intel CPUs
adapts 25MHz.
Con: Require the VMM to emulate the APIC timer at 25MHz.
2. Make the TDX architecture enumerate CPUID leaf 0x15 to configurable frequency or not enumerate it.
Pro: Any APIC bus frequency is allowed.
Con: Deviates from TDX architecture.
3. Make the TDX guest kernel use 1GHz when it's running on KVM.
Con: The kernel ignores CPUID leaf 0x15.
4. Change CPUID leaf 0x15 under TDX to report the crystal clock frequency as 1 GHz.
Pro: This has been the virtual APIC frequency for KVM guests for 13
years.
Pro: This requires changing only one hard-coded constant in TDX.
Con: It doesn't work with other VMMs as TDX isn't specific to KVM.
Con: Core crystal clock frequency is also used to calculate TSC
frequency.
Con: If it is configured to value different from hardware, it will
break the correctness of INTEL-PT Mini Time Count (MTC) packets in TDs.
---
Changes v6:
- Add Yuan Yao's Reviewed-by tag.
- Add Xiaoyao Li's Reviewed-by tag.
Changes v5:
- Rename capability KVM_CAP_X86_APIC_BUS_FREQUENCY -> KVM_CAP_X86_APIC_BUS_CYCLES_NS. (Xiaoyao Li)
- Add Rick's Reviewed-by tag.
Changes v4:
- Rework implementation following Sean's guidance in:
https://lore.kernel.org/all/[email protected]/
- Reword con #2 to acknowledge feedback. (Sean)
- Add the "con" information from Xiaoyao during earlier review of v2.
- Rework changelog to address comments related to "bus clock" vs "core crystal clock" frequency. (Xiaoyao)
- Drop snippet about impact on TSC deadline timer emulation. (Maxim)
- Drop Maxim Levitsky's "Reviewed-by" tag due to many changes to patch since tag received.
- Switch "Subject:" to match custom "KVM: X86:" -> "KVM: x86:"
Changes v3:
- Added reviewed-by Maxim Levitsky.
- Minor update of the commit message.
Changes v2:
- Add check if vcpu isn't created.
- Add check if lapic chip is in-kernel emulation.
- Fix build error for i386.
- Add document to api.rst.
- Typo in the commit message.
--- Documentation/virt/kvm/api.rst | 17 +++++++++++++++++ arch/x86/kvm/x86.c | 27 +++++++++++++++++++++++++++ include/uapi/linux/kvm.h | 1 + 3 files changed, 45 insertions(+)
Documentation/virt/kvm/api.rst +17 -0
@@ -8063,6 +8063,23 @@ error/annotated fault. See KVM_EXIT_MEMORY_FAULT for more information. +7.35 KVM_CAP_X86_APIC_BUS_CYCLES_NS +----------------------------------- + +:Architectures: x86 +:Target: VM +:Parameters: args[0] is the desired APIC bus clock rate, in nanoseconds +:Returns: 0 on success, -EINVAL if args[0] contains an invalid value for the + frequency or if any vCPUs have been created, -ENXIO if a virtual + local APIC has not been created using KVM_CREATE_IRQCHIP. + +This capability sets VM's APIC bus clock frequency, used by KVM's in-kernel +virtual APIC when emulating APIC timers. KVM's default value can be retrieved +by KVM_CHECK_EXTENSION. + +Note: Userspace is responsible for correctly configuring CPUID 0x15, a.k.a. the +core crystal clock frequency, if a non-zero CPUID 0x15 is exposed to the guest. + 8. Other capabilities. ======================
arch/x86/kvm/x86.c +27 -0
@@ -4712,6 +4712,9 @@ int kvm_vm_ioctl_check_extension(struct kvm *kvm, long ext)case KVM_CAP_MEMORY_FAULT_INFO : r =1 ;break ; +case KVM_CAP_X86_APIC_BUS_CYCLES_NS : + r =APIC_BUS_CYCLE_NS_DEFAULT ; +break ;case KVM_CAP_EXIT_HYPERCALL : r =KVM_EXIT_HYPERCALL_VALID_MASK ;break ;
@@ -6752,6 +6755,30 @@ int kvm_vm_ioctl_enable_cap(struct kvm *kvm, }mutex_unlock (&kvm->lock);break ; +case KVM_CAP_X86_APIC_BUS_CYCLES_NS : { +u64 bus_cycle_ns = cap->args[0 ]; +u64 unused; + + r = -EINVAL ; +/* +* Guard against overflow in tmict_to_ns(). 128 is the highest +* divide value that can be programmed in APIC_TDCR. +*/ +if (!bus_cycle_ns || +check_mul_overflow ((u64 )U32_MAX *128 , bus_cycle_ns, &unused)) +break ; + + r =0 ; +mutex_lock (&kvm->lock); +if (!irqchip_in_kernel (kvm)) + r = -ENXIO ; +else if (kvm->created_vcpus) + r = -EINVAL ; +else + kvm->arch.apic_bus_cycle_ns = bus_cycle_ns; +mutex_unlock (&kvm->lock); +break ; + }default : r = -EINVAL ;break ;
include/uapi/linux/kvm.h +1 -0
@@ -917,6 +917,7 @@ struct kvm_enable_cap {#define KVM_CAP_MEMORY_ATTRIBUTES 233#define KVM_CAP_GUEST_MEMFD 234#define KVM_CAP_VM_TYPES 235 +#define KVM_CAP_X86_APIC_BUS_CYCLES_NS 236struct kvm_irq_routing_irqchip {__u32 irqchip;
Signature · 1 line
2.34.1
PATCH v6 4/4 KVM: selftests: Add test for configure of x86 APIC bus frequency
In reply to Reinette ChatreFrom: Isaku Yamahata <[email protected]>
Test if the APIC bus clock frequency is the expected configured value.
Set APIC timer's initial count to the maximum value and busy wait for 100 msec (any value is okay) with TSC value. Read the APIC timer's "current count" to calculate the actual APIC bus clock frequency based on TSC frequency.
---
Changes v6:
- Use vm_create() wrapper instead of open coding it. (Zide)
- Improve grammar of test description. (Zide)
Changes v5:
- Update to new name of capability KVM_CAP_X86_APIC_BUS_FREQUENCY -> KVM_CAP_X86_APIC_BUS_CYCLES_NS. (Xiaoyao Li)
Changes v4:
- Rework changelog.
- Add Sean's "Suggested-by" to acknowledge guidance received in
https://lore.kernel.org/all/[email protected]/
- Add copyright.
- Add test description to file header.
- Consistent capitalization for acronyms.
- Rebase to kvm-x86/next.
- Update to v4 change of providing bus clock rate in nanoseconds.
- Add a "TEST_REQUIRE()" for the new capability so that the test can work on kernels that do not support the new capability.
- Address checkpatch warnings and use tabs instead of spaces in header file to match existing code.
Changes v3:
- Use 1.5GHz instead of 1GHz as frequency.
Changes v2:
- Newly added.
--- tools/testing/selftests/kvm/Makefile | 1 + .../selftests/kvm/include/x86_64/apic.h | 7 + .../kvm/x86_64/apic_bus_clock_test.c | 166 ++++++++++++++++++ 3 files changed, 174 insertions(+) create mode 100644 tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c
tools/testing/selftests/kvm/Makefile +1 -0
@@ -111,6 +111,7 @@ TEST_GEN_PROGS_x86_64 += x86_64/vmx_invalid_nested_guest_state TEST_GEN_PROGS_x86_64 += x86_64/vmx_set_nested_state_test TEST_GEN_PROGS_x86_64 += x86_64/vmx_tsc_adjust_test TEST_GEN_PROGS_x86_64 += x86_64/vmx_nested_tsc_scaling_test +TEST_GEN_PROGS_x86_64 += x86_64/apic_bus_clock_test TEST_GEN_PROGS_x86_64 += x86_64/xapic_ipi_test TEST_GEN_PROGS_x86_64 += x86_64/xapic_state_test TEST_GEN_PROGS_x86_64 += x86_64/xcr0_cpuid_test
tools/testing/selftests/kvm/include/x86_64/apic.h +7 -0
@@ -60,6 +60,13 @@#define APIC_VECTOR_MASK 0x000FF#define APIC_ICR2 0x310#define SET_APIC_DEST_FIELD (x) ((x) << 24) +#define APIC_LVT0 0x350 +#define APIC_LVT_TIMER_ONESHOT (0 << 17) +#define APIC_LVT_TIMER_PERIODIC (1 << 17) +#define APIC_LVT_TIMER_TSCDEADLINE (2 << 17) +#define APIC_TMICT 0x380 +#define APIC_TMCCT 0x390 +#define APIC_TDCR 0x3E0void apic_disable (void );void xapic_enable (void );
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +166 -0
166 lines not on this page · raw message
Signature · 1 line
2.34.1
Re: [PATCH V6 4/4] KVM: selftests: Add test for configure of x86 APIC bus frequency
On 5/6/2024 11:35 AM, Reinette Chatre wrote:
...
Quoted 19 lines
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +13
-0@@ -0,0 +1,166 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* +* Test configure of APIC bus frequency. +* +* Copyright (c) 2024 Intel Corporation +* +* To verify if the APIC bus frequency can be configured this, test starts +* by setting the TSC frequency in KVM, and then: +* For every APIC timer frequency supported: +* * In the guest: +* * * Start the APIC timer by programming the APIC TMICT (initial count +* register) to the largest value possible to guarantee that it will +* not expire during the test,
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c line 23
Quoted 10 lines
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +10
-0+* * * Wait for a known duration based on previously set TSC frequency, +* * * Stop the timer and read the APIC TMCCT (current count) register to +* determine the count at that time (TMCCT is loaded from TMICT when +* TMICT is programmed and then starts counting down). +* * In the host: +* * * Determine if the APIC counts close to configured APIC bus frequency +* while taking into account how the APIC timer frequency was modified +* using the APIC TDCR (divide configuration register). +*/ +#define _GNU_SOURCE/* for program_invocation_short_name */
As reported in [1] this #define is no longer needed after commit 730cfa45b5f4 ("KVM: selftests: Define _GNU_SOURCE for all selftests code"). This will be fixed in next version of this series.
Reinette
Sean Christopherson
maintainerRe: [PATCH V6 4/4] KVM: selftests: Add test for configure of x86 APIC bus frequency
Quoted 26 lines · Reinette Chatre
Quoted 25 lines · Reinette Chatre
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +19
-0@@ -0,0 +1,166 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* +* Test configure of APIC bus frequency. +* +* Copyright (c) 2024 Intel Corporation +* +* To verify if the APIC bus frequency can be configured this, test starts +* by setting the TSC frequency in KVM, and then: +* For every APIC timer frequency supported: +* * In the guest: +* * * Start the APIC timer by programming the APIC TMICT (initial count +* register) to the largest value possible to guarantee that it will +* not expire during the test, +* * * Wait for a known duration based on previously set TSC frequency, +* * * Stop the timer and read the APIC TMCCT (current count) register to +* determine the count at that time (TMCCT is loaded from TMICT when +* TMICT is programmed and then starts counting down). +* * In the host: +* * * Determine if the APIC counts close to configured APIC bus frequency
Quoted 8 lines
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c line 23
Quoted 4 lines
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +4
-0+* while taking into account how the APIC timer frequency was modified +* using the APIC TDCR (divide configuration register). +*/ +#define _GNU_SOURCE/* for program_invocation_short_name */ As reported in [1] this #define is no longer needed after commit
730cfa45b5f4("KVM: selftests: Define_GNU_SOURCEfor all selftests code"). This will be fixed in next version of this series.
Don't worry about sending another version just for this, I can clean this up when applying.
Re: [PATCH V6 4/4] KVM: selftests: Add test for configure of x86 APIC bus frequency
Hi Sean,
Quoted 36 lines · Sean Christopherson
Quoted 26 lines · Reinette Chatre
Quoted 25 lines · Reinette Chatre
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +19
-0@@ -0,0 +1,166 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* +* Test configure of APIC bus frequency. +* +* Copyright (c) 2024 Intel Corporation +* +* To verify if the APIC bus frequency can be configured this, test starts +* by setting the TSC frequency in KVM, and then: +* For every APIC timer frequency supported: +* * In the guest: +* * * Start the APIC timer by programming the APIC TMICT (initial count +* register) to the largest value possible to guarantee that it will +* not expire during the test, +* * * Wait for a known duration based on previously set TSC frequency, +* * * Stop the timer and read the APIC TMCCT (current count) register to +* determine the count at that time (TMCCT is loaded from TMICT when +* TMICT is programmed and then starts counting down). +* * In the host: +* * * Determine if the APIC counts close to configured APIC bus frequency Quoted 8 lines
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c line 23
Quoted 4 lines
tools/testing/selftests/kvm/x86_64/apic_bus_clock_test.c new file +4
-0+* while taking into account how the APIC timer frequency was modified +* using the APIC TDCR (divide configuration register). +*/ +#define _GNU_SOURCE/* for program_invocation_short_name */ As reported in [1] this #define is no longer needed after commit
730cfa45b5f4("KVM: selftests: Define_GNU_SOURCEfor all selftests code"). This will be fixed in next version of this series.
Quoted 2 lines
Don't worry about sending another version just for this, I can clean this up when applying.
Thank you very much. At this time this is the only change planned for this series. I do not know the status of all completed and planned merges during the merge window, but I did a quick check and this series applies cleanly on top of today's tip of git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git. The kernel parts passed a bisect test cleanly, while the selftest encountered just the warning related to _GNU_SOURCE.
Reinette