[PATCH v5 8/8] KVM: SEV: Add support for SNP BTB Isolation
From: Kim Phillips
Date: Wed Aug 26 2026 - 18:41:30 EST
Advertise support for BTB Isolation via SEV_VMSA_FEATURES when SNP is
enabled. BTB Isolation is an optional feature that can be enabled by the
guest to ensure its guest Branch Target Buffers (BTBs) are not affected
by any context outside that guest.
SNP-active guests may choose to enable the Branch Target Buffer
Isolation mode through SEV_FEATURES bit 7 (BTBIsolation).
Unlike the sibling features advertised here (Secure TSC, IBPB-on-Entry),
BTB Isolation is advertised unconditionally. This is deliberate, not an
oversight: the AMD64 APM (Vol. 2, Section 15.36.17 "Side-Channel
Protection") defines BTB Isolation as architecturally present on every
SEV-SNP-capable processor. There is therefore no host enumeration bit
for it (no CPUID leaf or MSR capability), by design -- unlike
IBPB-on-Entry, whose host support is enumerated via
CPUID Fn8000_001F[IbpbOnEntry] bit 31 precisely because it is not
universal. A per-feature host gate is thus neither possible nor
meaningful; if SNP is supported, BTB Isolation is present.
Nor does the guest have to take the host's word for it. SEV_FEATURES is
written into the VMSA by sev_es_sync_vmsa() and measured by
SNP_LAUNCH_UPDATE with SNP_PAGE_TYPE_VMSA, so bit 7 is covered by the
launch measurement and appears in the attestation report. At runtime the
guest can additionally read the active state from SEV_STATUS bit 9
(MSR_AMD64_SNP_BTB_ISOLATION, dumped as "BTBIsol" by
sev_status_feat_names[] in arch/x86/coco/sev/core.c). A guest requiring
BTB Isolation can therefore confirm it is active rather than trusting what
the host advertised.
Also add SVM_SEV_FEAT_BTB_ISOLATION to the sev_init2 selftest's
SNP_ONLY_FEATURES and KNOWN_FEATURES to validate it is accepted
for SNP guests and rejected for SEV-ES.
For more info, refer to page 615, Section 15.36.17 "Side-Channel
Protection", AMD64 Architecture Programmer's Manual Volume 2: System
Programming Part 2, Pub. 24593 Rev. 3.42 - March 2024 (see Link).
Link: https://bugzilla.kernel.org/attachment.cgi?id=306250
Cc: Sean Christopherson <seanjc@xxxxxxxxxx>
Cc: Borislav Petkov (AMD) <bp@xxxxxxxxx>
Signed-off-by: Kim Phillips <kim.phillips@xxxxxxx>
Assisted-by: ClaudeCode:claude-opus-4-7
Reviewed-by: Tom Lendacky <thomas.lendacky@xxxxxxx>
---
arch/x86/include/asm/svm.h | 2 ++
arch/x86/kvm/svm/sev.c | 8 ++++++++
tools/testing/selftests/kvm/x86/sev_init2_tests.c | 2 ++
3 files changed, 12 insertions(+)
diff --git a/arch/x86/include/asm/svm.h b/arch/x86/include/asm/svm.h
index 9d8107824d10..0da2234b71c6 100644
--- a/arch/x86/include/asm/svm.h
+++ b/arch/x86/include/asm/svm.h
@@ -309,10 +309,12 @@ static_assert((X2AVIC_4K_MAX_PHYSICAL_ID & AVIC_PHYSICAL_MAX_INDEX_MASK) == X2AV
#define SVM_SEV_FEAT_RESTRICTED_INJECTION BIT_ULL(3)
#define SVM_SEV_FEAT_ALTERNATE_INJECTION BIT_ULL(4)
#define SVM_SEV_FEAT_DEBUG_SWAP BIT_ULL(5)
+#define SVM_SEV_FEAT_BTB_ISOLATION BIT_ULL(7)
#define SVM_SEV_FEAT_SECURE_TSC BIT_ULL(9)
#define SVM_SEV_FEAT_IBPB_ON_ENTRY BIT_ULL(21)
#define SVM_SEV_FEAT_SNP_ONLY_MASK (SVM_SEV_FEAT_SNP_ACTIVE | \
+ SVM_SEV_FEAT_BTB_ISOLATION | \
SVM_SEV_FEAT_SECURE_TSC | \
SVM_SEV_FEAT_IBPB_ON_ENTRY)
diff --git a/arch/x86/kvm/svm/sev.c b/arch/x86/kvm/svm/sev.c
index 20a761cf3491..53cc6d043883 100644
--- a/arch/x86/kvm/svm/sev.c
+++ b/arch/x86/kvm/svm/sev.c
@@ -3260,6 +3260,14 @@ void __init sev_hardware_setup(void)
if (sev_snp_enabled) {
sev_supported_vmsa_features |= SVM_SEV_FEAT_SNP_ACTIVE;
+ /*
+ * Unlike Secure TSC and IBPB-on-Entry below, BTB Isolation has
+ * no host enumeration bit to gate on: the APM defines it as
+ * architecturally present on every SEV-SNP-capable processor.
+ * If SNP is supported, BTB Isolation is available.
+ */
+ sev_supported_vmsa_features |= SVM_SEV_FEAT_BTB_ISOLATION;
+
if (tsc_khz && cpu_feature_enabled(X86_FEATURE_SNP_SECURE_TSC))
sev_supported_vmsa_features |= SVM_SEV_FEAT_SECURE_TSC;
diff --git a/tools/testing/selftests/kvm/x86/sev_init2_tests.c b/tools/testing/selftests/kvm/x86/sev_init2_tests.c
index f2f97dca3935..3f592e245a66 100644
--- a/tools/testing/selftests/kvm/x86/sev_init2_tests.c
+++ b/tools/testing/selftests/kvm/x86/sev_init2_tests.c
@@ -15,11 +15,13 @@
#define SVM_SEV_FEAT_SNP_ACTIVE BIT_ULL(0)
#define SVM_SEV_FEAT_DEBUG_SWAP BIT_ULL(5)
+#define SVM_SEV_FEAT_BTB_ISOLATION BIT_ULL(7)
#define SVM_SEV_FEAT_SECURE_TSC BIT_ULL(9)
#define SVM_SEV_FEAT_IBPB_ON_ENTRY BIT_ULL(21)
/* Features valid only for SNP guests, rejected for SEV-ES and below. */
#define SNP_ONLY_FEATURES (SVM_SEV_FEAT_SNP_ACTIVE | \
+ SVM_SEV_FEAT_BTB_ISOLATION | \
SVM_SEV_FEAT_SECURE_TSC | \
SVM_SEV_FEAT_IBPB_ON_ENTRY)
--
2.43.0