From: Manali Shukla <manali.shukla@amd.com>
To: <seanjc@google.com>, <pbonzini@redhat.com>
Cc: <mingo@redhat.com>, <bp@alien8.de>, <dave.hansen@linux.intel.com>,
<kvm@vger.kernel.org>, <x86@kernel.org>, <santosh.shukla@amd.com>,
<nikunj.dadhania@amd.com>, <Naveen.Rao@amd.com>,
<dapeng1.mi@linux.intel.com>, <manali.shukla@amd.com>
Subject: [PATCH v1 1/9] KVM: x86: Refactor APIC register mask handling to support extended APIC registers
Date: Wed, 4 Feb 2026 07:44:44 +0000 [thread overview]
Message-ID: <20260204074452.55453-2-manali.shukla@amd.com> (raw)
In-Reply-To: <20260204074452.55453-1-manali.shukla@amd.com>
Expand the APIC register mask infrastructure from a single u64 to
a u64[2] array to accommodate both standard APIC registers (0x0-0x3f0)
and extended APIC registers (0x400-0x530). Current AMD processors
support four extended LVT registers; future processors may support up to
255.
The existing single 64-bit mask can track at most 64 registers (with 16-
byte granularity), which is insufficient for the extended APIC register
space. A 128-bit mask (u64[2]) provides coverage for both standard and
extended register ranges.
Convert the bitmask infrastructure to use kernel bitmap APIs.
APIC_REG_MASK now sets bits in the u64[2] array via bitmap_set(),
APIC_REG_TEST checks register validity via test_bit(), and
kvm_lapic_readable_reg_mask() populates the expanded mask as an output
parameter instead of a return value.
Update all callers, including vmx_update_msr_bitmap_x2apic() in VMX, to
pass and utilize the new two-element mask array. Currently, extended
APIC registers are only supported for AMD processors.
No functional change intended; extended APIC register emulation will be
added in a subsequent patch.
Suggested-by: Naveen N Rao (AMD) <naveen@kernel.org>
Suggested-by: Dapeng Mi <dapeng1.mi@linux.intel.com>
Signed-off-by: Manali Shukla <manali.shukla@amd.com>
---
arch/x86/kvm/lapic.c | 96 ++++++++++++++++++++++++++----------------
arch/x86/kvm/lapic.h | 2 +-
arch/x86/kvm/vmx/vmx.c | 10 +++--
3 files changed, 67 insertions(+), 41 deletions(-)
diff --git a/arch/x86/kvm/lapic.c b/arch/x86/kvm/lapic.c
index 2e513f1c8988..66819397e073 100644
--- a/arch/x86/kvm/lapic.c
+++ b/arch/x86/kvm/lapic.c
@@ -1664,53 +1664,74 @@ static inline struct kvm_lapic *to_lapic(struct kvm_io_device *dev)
return container_of(dev, struct kvm_lapic, dev);
}
-#define APIC_REG_MASK(reg) (1ull << ((reg) >> 4))
-#define APIC_REGS_MASK(first, count) \
- (APIC_REG_MASK(first) * ((1ull << (count)) - 1))
-
-u64 kvm_lapic_readable_reg_mask(struct kvm_lapic *apic)
-{
- /* Leave bits '0' for reserved and write-only registers. */
- u64 valid_reg_mask =
- APIC_REG_MASK(APIC_ID) |
- APIC_REG_MASK(APIC_LVR) |
- APIC_REG_MASK(APIC_TASKPRI) |
- APIC_REG_MASK(APIC_PROCPRI) |
- APIC_REG_MASK(APIC_LDR) |
- APIC_REG_MASK(APIC_SPIV) |
- APIC_REGS_MASK(APIC_ISR, APIC_ISR_NR) |
- APIC_REGS_MASK(APIC_TMR, APIC_ISR_NR) |
- APIC_REGS_MASK(APIC_IRR, APIC_ISR_NR) |
- APIC_REG_MASK(APIC_ESR) |
- APIC_REG_MASK(APIC_ICR) |
- APIC_REG_MASK(APIC_LVTT) |
- APIC_REG_MASK(APIC_LVTTHMR) |
- APIC_REG_MASK(APIC_LVTPC) |
- APIC_REG_MASK(APIC_LVT0) |
- APIC_REG_MASK(APIC_LVT1) |
- APIC_REG_MASK(APIC_LVTERR) |
- APIC_REG_MASK(APIC_TMICT) |
- APIC_REG_MASK(APIC_TMCCT) |
- APIC_REG_MASK(APIC_TDCR);
+/*
+ * Helper macros for APIC register bitmask handling
+ * 2 element array is being used to represent 128-bit mask, where:
+ * - mask[0] tracks standard APIC registers
+ * - mask[1] tracks extended APIC registers
+ */
+
+#define APIC_REG_BITMAP_WORDS 2 /* 2 x 64-bit words = 128 bits */
+#define APIC_REG_BITMAP_BITS (APIC_REG_BITMAP_WORDS * BITS_PER_LONG)
+
+#define APIC_REG_TO_BIT(reg) (((reg) < 0x400) ? ((reg) >> 4) : \
+ (64 + (((reg) - 0x400) >> 4)))
+
+#define APIC_REG_MASK(reg, mask) \
+ bitmap_set((unsigned long *)(mask), APIC_REG_TO_BIT(reg), 1)
+
+#define APIC_REGS_MASK(first, count, mask) \
+ bitmap_set((unsigned long *)(mask), APIC_REG_TO_BIT(first), (count))
+
+#define APIC_REG_TEST(reg, mask) \
+ test_bit(APIC_REG_TO_BIT(reg), (unsigned long *)(mask))
+
+#define APIC_LAST_REG_OFFSET 0x3f0
+
+void kvm_lapic_readable_reg_mask(struct kvm_lapic *apic, u64 mask[2])
+{
+ bitmap_zero((unsigned long *)(mask), APIC_REG_BITMAP_BITS);
+
+ APIC_REG_MASK(APIC_ID, mask);
+ APIC_REG_MASK(APIC_LVR, mask);
+ APIC_REG_MASK(APIC_TASKPRI, mask);
+ APIC_REG_MASK(APIC_PROCPRI, mask);
+ APIC_REG_MASK(APIC_LDR, mask);
+ APIC_REG_MASK(APIC_SPIV, mask);
+ APIC_REGS_MASK(APIC_ISR, APIC_ISR_NR, mask);
+ APIC_REGS_MASK(APIC_TMR, APIC_ISR_NR, mask);
+ APIC_REGS_MASK(APIC_IRR, APIC_ISR_NR, mask);
+ APIC_REG_MASK(APIC_ESR, mask);
+ APIC_REG_MASK(APIC_ICR, mask);
+ APIC_REG_MASK(APIC_LVTT, mask);
+ APIC_REG_MASK(APIC_LVTTHMR, mask);
+ APIC_REG_MASK(APIC_LVTPC, mask);
+ APIC_REG_MASK(APIC_LVT0, mask);
+ APIC_REG_MASK(APIC_LVT1, mask);
+ APIC_REG_MASK(APIC_LVTERR, mask);
+ APIC_REG_MASK(APIC_TMICT, mask);
+ APIC_REG_MASK(APIC_TMCCT, mask);
+ APIC_REG_MASK(APIC_TDCR, mask);
if (kvm_lapic_lvt_supported(apic, LVT_CMCI))
- valid_reg_mask |= APIC_REG_MASK(APIC_LVTCMCI);
+ APIC_REG_MASK(APIC_LVTCMCI, mask);
/* ARBPRI, DFR, and ICR2 are not valid in x2APIC mode. */
- if (!apic_x2apic_mode(apic))
- valid_reg_mask |= APIC_REG_MASK(APIC_ARBPRI) |
- APIC_REG_MASK(APIC_DFR) |
- APIC_REG_MASK(APIC_ICR2);
-
- return valid_reg_mask;
+ if (!apic_x2apic_mode(apic)) {
+ APIC_REG_MASK(APIC_ARBPRI, mask);
+ APIC_REG_MASK(APIC_DFR, mask);
+ APIC_REG_MASK(APIC_ICR2, mask);
+ }
}
EXPORT_SYMBOL_FOR_KVM_INTERNAL(kvm_lapic_readable_reg_mask);
static int kvm_lapic_reg_read(struct kvm_lapic *apic, u32 offset, int len,
void *data)
{
+ unsigned int last_reg = APIC_LAST_REG_OFFSET;
unsigned char alignment = offset & 0xf;
u32 result;
+ u64 mask[2];
/*
* WARN if KVM reads ICR in x2APIC mode, as it's an 8-byte register in
@@ -1721,8 +1742,9 @@ static int kvm_lapic_reg_read(struct kvm_lapic *apic, u32 offset, int len,
if (alignment + len > 4)
return 1;
- if (offset > 0x3f0 ||
- !(kvm_lapic_readable_reg_mask(apic) & APIC_REG_MASK(offset)))
+ kvm_lapic_readable_reg_mask(apic, mask);
+
+ if (offset > last_reg || !APIC_REG_TEST(offset, mask))
return 1;
result = __apic_read(apic, offset & ~0xf);
diff --git a/arch/x86/kvm/lapic.h b/arch/x86/kvm/lapic.h
index adf04a9bd57d..152f17903ff0 100644
--- a/arch/x86/kvm/lapic.h
+++ b/arch/x86/kvm/lapic.h
@@ -156,7 +156,7 @@ int kvm_hv_vapic_msr_read(struct kvm_vcpu *vcpu, u32 msr, u64 *data);
int kvm_lapic_set_pv_eoi(struct kvm_vcpu *vcpu, u64 data, unsigned long len);
void kvm_lapic_exit(void);
-u64 kvm_lapic_readable_reg_mask(struct kvm_lapic *apic);
+void kvm_lapic_readable_reg_mask(struct kvm_lapic *apic, u64 mask[2]);
static inline void kvm_lapic_set_irr(int vec, struct kvm_lapic *apic)
{
diff --git a/arch/x86/kvm/vmx/vmx.c b/arch/x86/kvm/vmx/vmx.c
index 9e6c78a22b10..35440753e5c6 100644
--- a/arch/x86/kvm/vmx/vmx.c
+++ b/arch/x86/kvm/vmx/vmx.c
@@ -4231,10 +4231,14 @@ static void vmx_update_msr_bitmap_x2apic(struct kvm_vcpu *vcpu)
* through reads for all valid registers by default in x2APIC+APICv
* mode, only the current timer count needs on-demand emulation by KVM.
*/
- if (mode & MSR_BITMAP_MODE_X2APIC_APICV)
- msr_bitmap[read_idx] = ~kvm_lapic_readable_reg_mask(vcpu->arch.apic);
- else
+ if (mode & MSR_BITMAP_MODE_X2APIC_APICV) {
+ u64 mask[2];
+
+ kvm_lapic_readable_reg_mask(vcpu->arch.apic, mask);
+ msr_bitmap[read_idx] = ~mask[0];
+ } else {
msr_bitmap[read_idx] = ~0ull;
+ }
msr_bitmap[write_idx] = ~0ull;
/*
--
2.43.0
next prev parent reply other threads:[~2026-02-04 7:45 UTC|newest]
Thread overview: 24+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-02-04 7:44 [PATCH v1 0/9] KVM: x86: Add support for AMD Extended APIC registers Manali Shukla
2026-02-04 7:44 ` Manali Shukla [this message]
2026-05-14 12:48 ` [PATCH v1 1/9] KVM: x86: Refactor APIC register mask handling to support extended " Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 2/9] x86/apic: Add helper to get maximum number of Extended LVT registers Manali Shukla
2026-05-06 11:22 ` Borislav Petkov
2026-05-14 12:50 ` Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 3/9] KVM: SVM: Set kvm_caps.has_extapic when CPU supports Extended APIC Manali Shukla
2026-05-14 12:58 ` Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 4/9] KVM: x86: Introduce KVM_CAP_LAPIC2 for 4KB APIC register space support Manali Shukla
2026-05-14 13:08 ` Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 5/9] KVM: x86: Refactor APIC state get/set to accept variable-sized buffers Manali Shukla
2026-05-14 14:20 ` Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 6/9] KVM: Add KVM_GET_LAPIC2 and KVM_SET_LAPIC2 for extended APIC Manali Shukla
2026-03-16 13:00 ` Nikunj A. Dadhania
2026-03-23 11:15 ` Manali Shukla
2026-05-14 14:36 ` Naveen N Rao
2026-05-14 14:41 ` Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 7/9] KVM: x86: Emulate Extended LVT registers for AMD guests Manali Shukla
2026-05-14 14:48 ` Naveen N Rao
2026-02-04 7:44 ` [PATCH v1 8/9] x86/cpufeatures: Add CPUID feature bit for Extended LVT AVIC acceleration Manali Shukla
2026-02-04 7:44 ` [PATCH v1 9/9] KVM: SVM: Add AVIC support for extended LVT MSRs Manali Shukla
2026-05-14 15:10 ` Naveen N Rao
2026-03-10 6:17 ` [PATCH v1 0/9] KVM: x86: Add support for AMD Extended APIC registers Manali Shukla
2026-04-27 4:34 ` Shukla, Manali
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260204074452.55453-2-manali.shukla@amd.com \
--to=manali.shukla@amd.com \
--cc=Naveen.Rao@amd.com \
--cc=bp@alien8.de \
--cc=dapeng1.mi@linux.intel.com \
--cc=dave.hansen@linux.intel.com \
--cc=kvm@vger.kernel.org \
--cc=mingo@redhat.com \
--cc=nikunj.dadhania@amd.com \
--cc=pbonzini@redhat.com \
--cc=santosh.shukla@amd.com \
--cc=seanjc@google.com \
--cc=x86@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox