[PATCH RFC v2 1/2] KVM: arm64: CCA: Add support for configuring the Realm MEC policy
From: Kohei Enju
Date: Wed Nov 11 2026 - 22:37:32 EST
Introduce the KVM_ARM_VM_RMI_CTRL device attribute group to allow
userspace to configure Realm VM parameters before the Realm is created
using KVM_SET_DEVICE_ATTR.
Currently, KVM_ARM_VM_RMI_CTRL_MEC_POLICY is the only supported
attribute. Its value can be KVM_ARM_VM_RMI_MEC_POLICY_SHARED or
KVM_ARM_VM_RMI_MEC_POLICY_PRIVATE. Reject the private policy if the
platform does not support private MECs.
If userspace does not explicitly configure the MEC policy,
KVM_ARM_VM_RMI_MEC_POLICY_SHARED is used by default.
Signed-off-by: Kohei Enju <enju.kohei@xxxxxxxxxxx>
---
Documentation/virt/kvm/devices/vm.rst | 25 +++++++++++++++
arch/arm64/include/asm/kvm_rmi.h | 5 +++
arch/arm64/include/uapi/asm/kvm.h | 4 +++
arch/arm64/kvm/arm.c | 4 +++
arch/arm64/kvm/rmi.c | 57 +++++++++++++++++++++++++++++++++
drivers/firmware/arm_rmm/rmi.c | 6 ++++
include/linux/arm-rmi-cmds.h | 1 +
tools/arch/arm64/include/uapi/asm/kvm.h | 4 +++
8 files changed, 106 insertions(+)
diff --git a/Documentation/virt/kvm/devices/vm.rst b/Documentation/virt/kvm/devices/vm.rst
index 78e63eb9994e..b0bd30750aa1 100644
--- a/Documentation/virt/kvm/devices/vm.rst
+++ b/Documentation/virt/kvm/devices/vm.rst
@@ -418,3 +418,28 @@ will reject attempts to define a filter for any portion of these ranges:
0x8000_0000 0x8000_FFFF
0xC000_0000 0xC000_FFFF
=========== ===============
+
+7. GROUP: KVM_ARM_VM_RMI_CTRL
+=============================
+
+:Architectures: arm64
+
+7.1. ATTRIBUTE: KVM_ARM_VM_RMI_CTRL_MEC_POLICY (w/o)
+----------------------------------------------------
+
+:Parameters: Pointer to a ``__u8`` value
+
+:Returns:
+
+ ========= ===========================================================
+ ENXIO The VM is not a Realm VM
+ EBUSY The Realm has already been created
+ EINVAL Invalid MEC policy value
+ EOPNOTSUPP Private MEC policy is not supported by the platform
+ EFAULT The value could not be copied from userspace
+ ========= ===========================================================
+
+Configures the MEC policy for a Realm VM before the Realm is created. The value
+must be either ``KVM_ARM_VM_RMI_MEC_POLICY_SHARED`` or
+``KVM_ARM_VM_RMI_MEC_POLICY_PRIVATE``. If userspace does not explicitly set the
+MEC policy, ``KVM_ARM_VM_RMI_MEC_POLICY_SHARED`` is used by default.
diff --git a/arch/arm64/include/asm/kvm_rmi.h b/arch/arm64/include/asm/kvm_rmi.h
index 3933f8d834b8..08c1f6d0671d 100644
--- a/arch/arm64/include/asm/kvm_rmi.h
+++ b/arch/arm64/include/asm/kvm_rmi.h
@@ -59,6 +59,7 @@ enum realm_state {
* @state: The lifetime state machine for the realm
* @ia_bits: Number of valid Input Address bits in the IPA
* @stage2_unmapped: The Realm stage-2 mappings have been removed
+ * @mec_policy: MEC policy for the Realm VM
*/
struct realm {
void *rd;
@@ -73,6 +74,7 @@ struct realm {
enum realm_state state;
unsigned int ia_bits;
bool stage2_unmapped;
+ unsigned int mec_policy;
};
/**
@@ -109,9 +111,12 @@ int kvm_realm_teardown_stage2(struct kvm *kvm);
void kvm_destroy_rec(struct kvm_vcpu *vcpu);
struct kvm_arm_rmi_populate;
+struct kvm_device_attr;
int kvm_arm_rmi_populate(struct kvm *kvm,
struct kvm_arm_rmi_populate *arg);
+int kvm_vm_rmi_has_attr(struct kvm *kvm, struct kvm_device_attr *attr);
+int kvm_vm_rmi_set_attr(struct kvm *kvm, struct kvm_device_attr *attr);
enum kvm_gfn_range_filter;
diff --git a/arch/arm64/include/uapi/asm/kvm.h b/arch/arm64/include/uapi/asm/kvm.h
index 65ee09bd1463..aa1e6fe6192e 100644
--- a/arch/arm64/include/uapi/asm/kvm.h
+++ b/arch/arm64/include/uapi/asm/kvm.h
@@ -403,6 +403,10 @@ enum {
/* Device Control API on vm fd */
#define KVM_ARM_VM_SMCCC_CTRL 0
#define KVM_ARM_VM_SMCCC_FILTER 0
+#define KVM_ARM_VM_RMI_CTRL 1
+#define KVM_ARM_VM_RMI_CTRL_MEC_POLICY 0
+#define KVM_ARM_VM_RMI_MEC_POLICY_SHARED 0
+#define KVM_ARM_VM_RMI_MEC_POLICY_PRIVATE 1
/* Device Control API: ARM VGIC */
#define KVM_DEV_ARM_VGIC_GRP_ADDR 0
diff --git a/arch/arm64/kvm/arm.c b/arch/arm64/kvm/arm.c
index 8e94f1bff830..be676c13e219 100644
--- a/arch/arm64/kvm/arm.c
+++ b/arch/arm64/kvm/arm.c
@@ -2329,6 +2329,8 @@ static int kvm_vm_has_attr(struct kvm *kvm, struct kvm_device_attr *attr)
switch (attr->group) {
case KVM_ARM_VM_SMCCC_CTRL:
return kvm_vm_smccc_has_attr(kvm, attr);
+ case KVM_ARM_VM_RMI_CTRL:
+ return kvm_vm_rmi_has_attr(kvm, attr);
default:
return -ENXIO;
}
@@ -2339,6 +2341,8 @@ static int kvm_vm_set_attr(struct kvm *kvm, struct kvm_device_attr *attr)
switch (attr->group) {
case KVM_ARM_VM_SMCCC_CTRL:
return kvm_vm_smccc_set_attr(kvm, attr);
+ case KVM_ARM_VM_RMI_CTRL:
+ return kvm_vm_rmi_set_attr(kvm, attr);
default:
return -ENXIO;
}
diff --git a/arch/arm64/kvm/rmi.c b/arch/arm64/kvm/rmi.c
index 0d254fb80cde..01ac8d4fec7c 100644
--- a/arch/arm64/kvm/rmi.c
+++ b/arch/arm64/kvm/rmi.c
@@ -7,6 +7,7 @@
#include <linux/arm-rmi-cmds.h>
#include <linux/kvm_host.h>
#include <linux/overflow.h>
+#include <linux/uaccess.h>
#include <asm/daifflags.h>
#include <asm/kvm_emulate.h>
@@ -586,6 +587,9 @@ static int realm_create_rd(struct kvm *kvm)
params->flags0 |= RMI_REALM_PARAM_FLAG_PMU;
}
+ params->flags0 |= FIELD_PREP(RMI_REALM_PARAM_FLAG_MEC_POLICY_MASK,
+ realm->mec_policy);
+
r = realm_init_sve_param(kvm, params);
if (r)
goto out_undelegate_tables;
@@ -1481,6 +1485,57 @@ int kvm_arm_rmi_populate(struct kvm *kvm,
return ret;
}
+static int kvm_vm_rmi_set_mec_policy(struct kvm *kvm, u8 policy)
+{
+ guard(mutex)(&kvm->arch.config_lock);
+
+ if (!kvm_vm_is_realm(kvm))
+ return -ENXIO;
+
+ if (kvm_realm_state(kvm) != REALM_STATE_NONE)
+ return -EBUSY;
+
+ if (policy != KVM_ARM_VM_RMI_MEC_POLICY_SHARED &&
+ policy != KVM_ARM_VM_RMI_MEC_POLICY_PRIVATE)
+ return -EINVAL;
+
+ if (policy == KVM_ARM_VM_RMI_MEC_POLICY_PRIVATE &&
+ rmi_mec_count() == 0)
+ return -EOPNOTSUPP;
+
+ kvm->arch.realm.mec_policy = policy;
+ return 0;
+}
+
+int kvm_vm_rmi_has_attr(struct kvm *kvm, struct kvm_device_attr *attr)
+{
+ if (!kvm_vm_is_realm(kvm))
+ return -ENXIO;
+
+ switch (attr->attr) {
+ case KVM_ARM_VM_RMI_CTRL_MEC_POLICY:
+ return 0;
+ default:
+ return -ENXIO;
+ }
+}
+
+int kvm_vm_rmi_set_attr(struct kvm *kvm, struct kvm_device_attr *attr)
+{
+ void __user *uaddr = (void __user *)attr->addr;
+ u8 policy;
+
+ switch (attr->attr) {
+ case KVM_ARM_VM_RMI_CTRL_MEC_POLICY:
+ if (copy_from_user(&policy, uaddr, sizeof(policy)))
+ return -EFAULT;
+
+ return kvm_vm_rmi_set_mec_policy(kvm, policy);
+ default:
+ return -ENXIO;
+ }
+}
+
static int kvm_create_rec(struct kvm_vcpu *vcpu)
{
struct user_pt_regs *vcpu_regs = &vcpu->arch.ctxt.regs;
@@ -1695,6 +1750,8 @@ int kvm_init_realm(struct kvm *kvm)
{
struct realm *realm = &kvm->arch.realm;
+ realm->mec_policy = KVM_ARM_VM_RMI_MEC_POLICY_SHARED;
+
realm->sro = kmalloc_obj(*realm->sro);
if (!realm->sro)
return -ENOMEM;
diff --git a/drivers/firmware/arm_rmm/rmi.c b/drivers/firmware/arm_rmm/rmi.c
index 77255a90e0a6..27edf060d2d9 100644
--- a/drivers/firmware/arm_rmm/rmi.c
+++ b/drivers/firmware/arm_rmm/rmi.c
@@ -793,6 +793,12 @@ unsigned long rmi_feat_reg(unsigned int index)
}
EXPORT_SYMBOL_GPL(rmi_feat_reg);
+u64 rmi_mec_count(void)
+{
+ return u64_get_bits(rmi_feat_reg(4), RMI_FEATURE_REGISTER_4_MEC_COUNT);
+}
+EXPORT_SYMBOL_GPL(rmi_mec_count);
+
static int rmi_rmm_config_set(unsigned long cfg_ptr)
{
struct arm_smccc_1_2_regs regs = {
diff --git a/include/linux/arm-rmi-cmds.h b/include/linux/arm-rmi-cmds.h
index c13e8775898e..530136ccb791 100644
--- a/include/linux/arm-rmi-cmds.h
+++ b/include/linux/arm-rmi-cmds.h
@@ -68,6 +68,7 @@ static __always_inline void rmi_smccc_invoke_once(struct arm_smccc_1_2_regs *reg
}
unsigned long rmi_feat_reg(unsigned int index);
+u64 rmi_mec_count(void);
int rmi_delegate_range(phys_addr_t phys, unsigned long size,
phys_addr_t *out_phys);
diff --git a/tools/arch/arm64/include/uapi/asm/kvm.h b/tools/arch/arm64/include/uapi/asm/kvm.h
index 65ee09bd1463..aa1e6fe6192e 100644
--- a/tools/arch/arm64/include/uapi/asm/kvm.h
+++ b/tools/arch/arm64/include/uapi/asm/kvm.h
@@ -403,6 +403,10 @@ enum {
/* Device Control API on vm fd */
#define KVM_ARM_VM_SMCCC_CTRL 0
#define KVM_ARM_VM_SMCCC_FILTER 0
+#define KVM_ARM_VM_RMI_CTRL 1
+#define KVM_ARM_VM_RMI_CTRL_MEC_POLICY 0
+#define KVM_ARM_VM_RMI_MEC_POLICY_SHARED 0
+#define KVM_ARM_VM_RMI_MEC_POLICY_PRIVATE 1
/* Device Control API: ARM VGIC */
#define KVM_DEV_ARM_VGIC_GRP_ADDR 0
--
2.43.0