coco/TSM: Arm CCA guest TDISP lock/accept flow with verification and DMA enable
Subsystems (3)
v3 cover coco/TSM: Arm CCA guest TDISP lock/accept flow with verification and DMA enable
This patch series implements the TSM ->lock(), ->unlock(), and ->accept() callbacks required for the TDISP setup with Arm CCA as per the RMM ALP17 specification [1].
The series adds the guest-side DA plumbing needed to transition a device through TDI LOCK and RUN states, verify host-provided evidence against RMM-provided digests, validate interface-report MMIO mappings, and enable DMA only after attestation succeeds.
At a high level, the series includes:
- guest TSM callback registration and lock/unlock/accept hooks
- RHI DA helper support for TDI state transitions and object refresh
- host-cached DA object fetch APIs in guest
- RSI_VDEV_GET_INFO digest verification of certificate/VCA/report/measurement
- mapping validation for interface-report ranges and teardown on unlock
- DMA behavior updates for accepted devices (including swiotlb restrictions)
- vdev DMA enable after successful attestation
The series builds upon the TSM framework patches posted at [2]. A git repository containing all the related changes is available at [3].
Testing / Usage
echo ${DEVICE} > /sys/bus/pci/devices/${DEVICE}/driver/unbind
To transition the device to TDISP LOCK state:
echo tsm0 > /sys/bus/pci/devices/${DEVICE}/tsm/lock
To transition the device to TDISP RUN state:
echo 1 > /sys/bus/pci/devices/${DEVICE}/tsm/accept
echo ${DEVICE} > /sys/bus/pci/drivers_probe
Previous posting:
rfc-v1: https://lore.kernel.org/all/[email protected]
rfc-v2: https://lore.kernel.org/all/[email protected]
Changes from v2:
* rebase to latest kernel and core TSM changes
* Address review feedback.
* Interface report is now collected using core TSM framework
* swiotlb is now considered shared-memory pool and is not allowed to be used by accepted devices.
[1] https://developer.arm.com/-/cdn-downloads/permalink/Architectures/Armv9/DEN0137_1.1-alp17.zip
[2] https://lore.kernel.org/all/[email protected]
[3] https://gitlab.arm.com/linux-arm/linux-cca.git cca/topics/cca-tdisp-upstream-rfc-v3
Aneesh Kumar K.V (Arm) (11):
coco: guest: arm64: Guest TSM callback and realm device lock support
coco: guest: arm64: Fix a typo in the ARM_CCA_GUEST Kconfig help
string ("and" -> "an"). coco: guest: arm64: Add Realm Host Interface and guest DA helper
coco: guest: arm64: Support guest-initiated TDI lock/unlock
transitions
coco: guest: arm64: Refresh interface-report cache during device lock
coco: guest: arm64: Add measurement refresh via
RHI_DA_VDEV_GET_MEASUREMENTS
coco: guest: arm64: Add guest APIs to read host-cached DA objects
coco: guest: arm64: Verify DA evidence with RSI_VDEV_GET_INFO digests
coco: guest: arm64: Hook TSM accept to Realm TDISP RUN transition
coco: arm64: dma: Update force_dma_unencrypted for accepted devices
coco: guest: arm64: Enable vdev DMA after attestation
arch/arm64/include/asm/mem_encrypt.h | 6 +- arch/arm64/include/asm/rhi.h | 58 ++++ arch/arm64/include/asm/rsi.h | 1 + arch/arm64/include/asm/rsi_cmds.h | 73 +++++ arch/arm64/include/asm/rsi_smc.h | 51 +++ arch/arm64/kernel/rsi.c | 10 + arch/arm64/mm/mem_encrypt.c | 10 + drivers/virt/coco/Makefile | 2 +- drivers/virt/coco/arm-cca-guest/Kconfig | 9 +- drivers/virt/coco/arm-cca-guest/Makefile | 1 + drivers/virt/coco/arm-cca-guest/arm-cca.c | 358 +++++++++++++++++++++- drivers/virt/coco/arm-cca-guest/rhi-da.c | 345 +++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rhi-da.h | 17 + drivers/virt/coco/arm-cca-guest/rsi-da.c | 289 +++++++++++++++++ drivers/virt/coco/arm-cca-guest/rsi-da.h | 65 ++++ include/linux/swiotlb.h | 3 + kernel/dma/direct.c | 8 + kernel/dma/swiotlb.c | 3 + 18 files changed, 1301 insertions(+), 8 deletions(-) create mode 100644 drivers/virt/coco/arm-cca-guest/rhi-da.c create mode 100644 drivers/virt/coco/arm-cca-guest/rhi-da.h create mode 100644 drivers/virt/coco/arm-cca-guest/rsi-da.c create mode 100644 drivers/virt/coco/arm-cca-guest/rsi-da.h
Signature · 1 line
2.43.0
RFC PATCH v3 1/11 coco: guest: arm64: Guest TSM callback and realm device lock support
Register the TSM callback when the DA feature is supported by RSI. The build order is also adjusted so that the TSM class is created before the arm-cca-guest driver is initialized.
In addition, add support for the TDISP lock sequence. Writing a TSM (TEE Security Manager) device name from /sys/class/tsm into tsm/lock triggers the realm device lock operation.
--- arch/arm64/include/asm/rsi.h | 1 + arch/arm64/include/asm/rsi_cmds.h | 17 +++++++ arch/arm64/include/asm/rsi_smc.h | 1 + arch/arm64/kernel/rsi.c | 10 ++++ drivers/virt/coco/Makefile | 2 +- drivers/virt/coco/arm-cca-guest/Kconfig | 5 ++ drivers/virt/coco/arm-cca-guest/arm-cca.c | 60 ++++++++++++++++++++++- drivers/virt/coco/arm-cca-guest/rsi-da.h | 35 +++++++++++++ 8 files changed, 129 insertions(+), 2 deletions(-) create mode 100644 drivers/virt/coco/arm-cca-guest/rsi-da.h
arch/arm64/include/asm/rsi.h +1 -0
@@ -68,5 +68,6 @@ static inline int rsi_set_memory_range_shared(phys_addr_t start, RSI_CHANGE_DESTROYED); } +bool rsi_has_da_feature (void );unsigned long realm_get_hyp_pagesize (void );#endif /* __ASM_RSI_H_ */
arch/arm64/include/asm/rsi_cmds.h +17 -0
@@ -169,4 +169,21 @@ static inline unsigned long rsi_host_call(struct rsi_host_call *rhi_call) return res.a0; } +/** +* rsi_features() - Read feature register +* @index: Feature register index +* @out: Feature register value is written to this pointer +* +* Return: RSI return code +*/ +static inline unsigned long rsi_features (unsigned long index,u64 *out) +{ +struct arm_smccc_res res; + +arm_smccc_1_1_invoke (SMC_RSI_FEATURES , index, &res); + + *out = res.a1; +return res.a0; +} +#endif /* __ASM_RSI_CMDS_H */
arch/arm64/include/asm/rsi_smc.h +1 -0
@@ -53,6 +53,7 @@*/ #define SMC_RSI_ABI_VERSION SMC_RSI_FID(0x190) +#define RSI_FEATURE_REGISTER_0_DA BIT(0)/* * Read feature register. *
arch/arm64/kernel/rsi.c +10 -0
@@ -16,6 +16,7 @@#include <asm/rhi.h> static struct realm_config config; +static u64 rsi_feat_reg0;static unsigned long ipa_change_alignment =PAGE_SIZE ;unsigned long prot_ns_shared;
@@ -24,6 +25,12 @@ EXPORT_SYMBOL(prot_ns_shared);DEFINE_STATIC_KEY_FALSE_RO (rsi_present);EXPORT_SYMBOL (rsi_present); +bool rsi_has_da_feature (void ) +{ +return u64_get_bits (rsi_feat_reg0,RSI_FEATURE_REGISTER_0_DA ); +} +EXPORT_SYMBOL_GPL (rsi_has_da_feature); +bool cc_platform_has (enum cc_attr attr) {switch (attr) {
@@ -159,6 +166,9 @@ void __init arm64_rsi_init(void)if (!ipa_change_alignment)return ; +if (WARN_ON (rsi_features (0 , &rsi_feat_reg0))) +return ; + prot_ns_shared =BIT (config.ipa_bits -1 );if (arm64_ioremap_prot_hook_register (realm_ioremap_hook))
drivers/virt/coco/Makefile +1 -1
@@ -7,6 +7,6 @@ obj-$(CONFIG_ARM_PKVM_GUEST) += pkvm-guest/ obj-$(CONFIG_SEV_GUEST) += sev-guest/ obj-$(CONFIG_INTEL_TDX_GUEST) += tdx-guest/ obj-$(CONFIG_INTEL_TDX_HOST) += tdx-host/ -obj-$(CONFIG_ARM_CCA_GUEST) += arm-cca-guest/ obj-$(CONFIG_TSM) += tsm-core.o obj-$(CONFIG_TSM_GUEST) += guest/ +obj-$(CONFIG_ARM_CCA_GUEST) += arm-cca-guest/
drivers/virt/coco/arm-cca-guest/Kconfig +5 -0
@@ -1,11 +1,16 @@ +# SPDX-License-Identifier: GPL-2.0-only +# + config ARM_CCA_GUEST tristate "Arm CCA Guest driver" depends on ARM64 + select PCI_TSM if PCI select TSM_REPORTS select AUXILIARY_BUS help The driver provides userspace interface to request and attestation report from the Realm Management Monitor(RMM). + If the DA feature is supported, it also register with TSM framework. If you choose 'M' here, this module will be called arm-cca-guest.
drivers/virt/coco/arm-cca-guest/arm-cca.c +59 -1
88 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rsi-da.h new file +35 -0
@@ -0,0 +1,35 @@ +/* SPDX-License-Identifier: GPL-2.0-only */ +/* +* Copyright (C) 2026 ARM Ltd. +*/ + +#ifndef _VIRT_COCO_RSI_DA_H_ +#define _VIRT_COCO_RSI_DA_H_ + +#include <linux/pci.h> +#include <linux/pci-tsm.h> +#include <asm/rsi_smc.h> + +struct cca_guest_dsc { +struct pci_tsm_devsec pci; +}; + +static inline struct cca_guest_dsc *to_cca_guest_dsc (struct pci_dev *pdev) +{ +struct pci_tsm *tsm = pdev->tsm; + +if (!tsm) +return NULL ; + return container_of(tsm, struct cca_guest_dsc, pci.base_tsm); +} + +/* +* Linux use device requester id as the vdev id. +*/ +static inline int rsi_vdev_id (struct pci_dev *pdev) +{ +return (pci_domain_nr (pdev->bus) <<16 ) | +PCI_DEVID (pdev->bus->number, pdev->devfn); +} + +#endif
Signature · 1 line
2.43.0
RFC PATCH v3 2/11 coco: guest: arm64: Fix a typo in the ARM_CCA_GUEST Kconfig help string ("and" -> "an").
In reply to Aneesh Kumar K.V (Arm)Fix a typo in Kconfig file.
--- drivers/virt/coco/arm-cca-guest/Kconfig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/virt/coco/arm-cca-guest/Kconfig +1 -1
@@ -8,7 +8,7 @@ config ARM_CCA_GUEST select TSM_REPORTS select AUXILIARY_BUS help - The driver provides userspace interface to request and + The driver provides userspace interface to request an attestation report from the Realm Management Monitor(RMM). If the DA feature is supported, it also register with TSM framework.
Signature · 1 line
2.43.0
RFC PATCH v3 3/11 coco: guest: arm64: Add Realm Host Interface and guest DA helper
In reply to Aneesh Kumar K.V (Arm)- Add guest-side rhi-da helper that drives the vdev TDI state machine via RHI host calls and translates the firmware status codes
This provides the basic RHI plumbing that later DA features rely on.
--- arch/arm64/include/asm/rhi.h | 37 +++++ drivers/virt/coco/arm-cca-guest/Makefile | 1 + drivers/virt/coco/arm-cca-guest/arm-cca.c | 3 +- drivers/virt/coco/arm-cca-guest/rhi-da.c | 158 ++++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rhi-da.h | 14 ++ 5 files changed, 212 insertions(+), 1 deletion(-) create mode 100644 drivers/virt/coco/arm-cca-guest/rhi-da.c create mode 100644 drivers/virt/coco/arm-cca-guest/rhi-da.h
arch/arm64/include/asm/rhi.h +37 -0
@@ -21,4 +21,41 @@ unsigned long rhi_get_ipa_change_alignment(void);#define __RHI_HOSTCONF_GET_IPA_CHANGE_ALIGNMENT BIT(0)#define RHI_HOSTCONF_FEATURES SMC_RHI_CALL(0x004F)#define RHI_HOSTCONF_GET_IPA_CHANGE_ALIGNMENT SMC_RHI_CALL(0x0050) + +#define RHI_DA_SUCCESS 0x0 +#define RHI_DA_ERROR_INCOMPLETE 0x1 +#define RHI_DA_ERROR_DATA_NOT_AVAILABLE 0x2 +#define RHI_DA_ERROR_INVALID_VDEV_ID 0x3 +#define RHI_DA_ERROR_INVALID_OBJECT 0x4 +#define RHI_DA_ERROR_INPUT 0x5 +#define RHI_DA_ERROR_DEVICE 0x6 +#define RHI_DA_ERROR_INVALID_OFFSET 0x7 +#define RHI_DA_ERROR_ACCESS_FAILED 0x8 +#define RHI_DA_ERROR_BUSY 0x9 +#define RHI_DA_ABORTED_OPERATION_HAD_COMPLETED 0xA + +#define RHI_DA_FEATURE_OBJECT_SIZE BIT(0) +#define RHI_DA_FEATURE_OBJECT_READ BIT(1) +#define RHI_DA_FEATURE_VDEV_CONTINUE BIT(2) +#define RHI_DA_FEATURE_VDEV_GET_MEASUREMENT BIT(3) +#define RHI_DA_FEATURE_VDEV_GET_INTF_REPORT BIT(4) +#define RHI_DA_FEATURE_VDEV_SET_TDI_STATE BIT(5) + +#define RHI_DA_BASE_FEATURE (RHI_DA_FEATURE_OBJECT_SIZE | \ + RHI_DA_FEATURE_OBJECT_READ | \ + RHI_DA_FEATURE_VDEV_GET_INTF_REPORT | \ + RHI_DA_FEATURE_VDEV_GET_MEASUREMENT | \ + RHI_DA_FEATURE_VDEV_SET_TDI_STATE) +#define RHI_DA_FEATURES SMC_RHI_CALL(0x004B) + +#define RHI_DA_VDEV_CONTINUE SMC_RHI_CALL(0x0051) + +enum rhi_tdi_state { +RHI_DA_TDI_CONFIG_UNLOCKED , +RHI_DA_TDI_CONFIG_LOCKED , +RHI_DA_TDI_CONFIG_RUN , +}; +#define RHI_DA_VDEV_SET_TDI_STATE SMC_RHI_CALL(0x0054) +#define RHI_DA_VDEV_ABORT SMC_RHI_CALL(0x0056) +#endif
drivers/virt/coco/arm-cca-guest/Makefile +1 -0
@@ -2,3 +2,4 @@ obj-$(CONFIG_ARM_CCA_GUEST) += arm-cca-guest.o arm-cca-guest-y += arm-cca.o +arm-cca-guest-$(CONFIG_PCI_TSM) += rhi-da.o
drivers/virt/coco/arm-cca-guest/arm-cca.c +2 -1
@@ -17,6 +17,7 @@#ifdef CONFIG_PCI_TSM #include "rsi-da.h" +#include "rhi-da.h" #endif /**
@@ -265,7 +266,7 @@ static int cca_devsec_tsm_probe(struct auxiliary_device *adev,#ifdef CONFIG_PCI_TSM /* Allow tsm report even if tsm_register fails */ -if (rsi_has_da_feature ()) +if (rsi_has_da_feature () &&rhi_has_da_support ())cca_devsec_tsm_register (adev);#endif
drivers/virt/coco/arm-cca-guest/rhi-da.c new file +158 -0
158 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rhi-da.h new file +14 -0
@@ -0,0 +1,14 @@ +/* SPDX-License-Identifier: GPL-2.0-only */ +/* +* Copyright (C) 2026 ARM Ltd. +*/ + +#ifndef _VIRT_COCO_RHI_DA_H_ +#define _VIRT_COCO_RHI_DA_H_ + +#include <asm/rhi.h> + +struct pci_dev ; +bool rhi_has_da_support (void ); +int rhi_vdev_set_tdi_state (struct pci_dev *pdev,enum rhi_tdi_state target_state); +#endif
Signature · 1 line
2.43.0
RFC PATCH v3 4/11 coco: guest: arm64: Support guest-initiated TDI lock/unlock transitions
In reply to Aneesh Kumar K.V (Arm)Add guest helpers to drive TDI state transitions through RHI:
- cca_device_lock() -> RHI_DA_TDI_CONFIG_LOCKED
- cca_device_unlock() -> RHI_DA_TDI_CONFIG_UNLOCKED
Use these helpers in the PCI TSM lock/unlock callbacks so a successful lock path returns a live pci_tsm handle and unlock transitions the device back to unlocked state.
--- drivers/virt/coco/arm-cca-guest/Makefile | 2 +- drivers/virt/coco/arm-cca-guest/arm-cca.c | 9 ++++-- drivers/virt/coco/arm-cca-guest/rsi-da.c | 34 +++++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rsi-da.h | 2 ++ 4 files changed, 44 insertions(+), 3 deletions(-) create mode 100644 drivers/virt/coco/arm-cca-guest/rsi-da.c
drivers/virt/coco/arm-cca-guest/Makefile +1 -1
@@ -2,4 +2,4 @@ obj-$(CONFIG_ARM_CCA_GUEST) += arm-cca-guest.o arm-cca-guest-y += arm-cca.o -arm-cca-guest-$(CONFIG_PCI_TSM) += rhi-da.o +arm-cca-guest-$(CONFIG_PCI_TSM) += rhi-da.o rsi-da.o
drivers/virt/coco/arm-cca-guest/arm-cca.c +7 -2
@@ -211,14 +211,19 @@ static struct pci_tsm *cca_tsm_lock(struct tsm_dev *tsm_dev, struct pci_dev *pdeif (ret)return ERR_PTR (ret); -/* For now always return an error */ -return ERR_PTR (-EIO ); + ret =cca_device_lock (pdev); +if (ret) +return ERR_PTR (ret); + +return &no_free_ptr (cca_dsc)->pci.base_tsm; }static void cca_tsm_unlock (struct pci_tsm *tsm) {struct cca_guest_dsc *cca_dsc =to_cca_guest_dsc (tsm->pdev); +cca_device_unlock (tsm->pdev); +kfree (cca_dsc); }
drivers/virt/coco/arm-cca-guest/rsi-da.c new file +34 -0
@@ -0,0 +1,34 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* +* Copyright (C) 2025 ARM Ltd. +*/ + +#include <linux/pci.h> +#include <asm/rsi_cmds.h> + +#include "rsi-da.h" +#include "rhi-da.h" + +int cca_device_lock (struct pci_dev *pdev) +{ +int ret; + + ret =rhi_vdev_set_tdi_state (pdev,RHI_DA_TDI_CONFIG_LOCKED ); +if (ret) { +pci_err (pdev,"failed to lock the device (%d)\n" , ret); +return ret; + } +return 0 ; +} + +int cca_device_unlock (struct pci_dev *pdev) +{ +int ret; + + ret =rhi_vdev_set_tdi_state (pdev,RHI_DA_TDI_CONFIG_UNLOCKED ); +if (ret) { +pci_err (pdev,"failed to unlock the device (%d)\n" , ret); +return ret; + } +return 0 ; +}
drivers/virt/coco/arm-cca-guest/rsi-da.h +2 -0
@@ -32,4 +32,6 @@ static inline int rsi_vdev_id(struct pci_dev *pdev) PCI_DEVID(pdev->bus->number, pdev->devfn); } +int cca_device_lock (struct pci_dev *pdev); +int cca_device_unlock (struct pci_dev *pdev);#endif
Signature · 1 line
2.43.0
RFC PATCH v3 5/11 coco: guest: arm64: Refresh interface-report cache during device lock
In reply to Aneesh Kumar K.V (Arm)Add support for RHI_DA_VDEV_GET_INTERFACE_REPORT and use it to refresh the host-side cached interface report when a device is locked.
Implement rhi_update_vdev_interface_report_cache() with busy retry and cookie-based CONTINUE handling for incomplete operations. Surface the flow through cca_update_device_object_cache(), and call it from the lock path so the interface report is fetched before lock succeeds.
On refresh failure, unwind by unlocking the device and returning the error.
--- arch/arm64/include/asm/rhi.h | 1 + drivers/virt/coco/arm-cca-guest/arm-cca.c | 6 ++++ drivers/virt/coco/arm-cca-guest/rhi-da.c | 44 +++++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rhi-da.h | 1 + drivers/virt/coco/arm-cca-guest/rsi-da.c | 13 +++++++ drivers/virt/coco/arm-cca-guest/rsi-da.h | 1 + 6 files changed, 66 insertions(+)
arch/arm64/include/asm/rhi.h +1 -0
@@ -49,6 +49,7 @@ unsigned long rhi_get_ipa_change_alignment(void);#define RHI_DA_FEATURES SMC_RHI_CALL(0x004B)#define RHI_DA_VDEV_CONTINUE SMC_RHI_CALL(0x0051) +#define RHI_DA_VDEV_GET_INTERFACE_REPORT SMC_RHI_CALL(0x0053)enum rhi_tdi_state {RHI_DA_TDI_CONFIG_UNLOCKED ,
drivers/virt/coco/arm-cca-guest/arm-cca.c +6 -0
@@ -215,6 +215,12 @@ static struct pci_tsm *cca_tsm_lock(struct tsm_dev *tsm_dev, struct pci_dev *pdeif (ret)return ERR_PTR (ret); + ret =cca_update_device_object_cache (pdev,NULL ); +if (ret) { +cca_device_unlock (pdev); +return ERR_PTR (ret); + } +return &no_free_ptr (cca_dsc)->pci.base_tsm; }
drivers/virt/coco/arm-cca-guest/rhi-da.c +44 -0
47 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rhi-da.h +1 -0
@@ -11,4 +11,5 @@struct pci_dev ;bool rhi_has_da_support (void );int rhi_vdev_set_tdi_state (struct pci_dev *pdev,enum rhi_tdi_state target_state); +int rhi_update_vdev_interface_report_cache (struct pci_dev *pdev);#endif
drivers/virt/coco/arm-cca-guest/rsi-da.c +13 -0
@@ -32,3 +32,16 @@ int cca_device_unlock(struct pci_dev *pdev) }return 0 ; } + +int cca_update_device_object_cache (struct pci_dev *pdev,const u8 *nonce) +{ +int ret; + + ret =rhi_update_vdev_interface_report_cache (pdev); +if (ret) { +pci_err (pdev,"failed to get interface report (%d)\n" , ret); +return ret; + } + +return 0 ; +}
drivers/virt/coco/arm-cca-guest/rsi-da.h +1 -0
@@ -34,4 +34,5 @@ static inline int rsi_vdev_id(struct pci_dev *pdev)int cca_device_lock (struct pci_dev *pdev);int cca_device_unlock (struct pci_dev *pdev); +int cca_update_device_object_cache (struct pci_dev *pdev,const u8 *nonce);#endif
Signature · 1 line
2.43.0
RFC PATCH v3 6/11 coco: guest: arm64: Add measurement refresh via RHI_DA_VDEV_GET_MEASUREMENTS
In reply to Aneesh Kumar K.V (Arm)Add guest support to request fresh device measurements using RHI_DA_VDEV_GET_MEASUREMENTS.
Define measurement request parameters (flags + nonce), request RAW measurements, and implement cookie-based continuation for incomplete DA operations. Extend cca_update_device_object_cache() to refresh both interface report and measurements.
Because RHI buffers are shared with the host, add shared-page allocation helpers that convert pages to decrypted/shared memory before use and restore them to encrypted/private state on free.
--- arch/arm64/include/asm/rhi.h | 13 ++++ drivers/virt/coco/arm-cca-guest/arm-cca.c | 1 + drivers/virt/coco/arm-cca-guest/rhi-da.c | 79 +++++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rhi-da.h | 1 + drivers/virt/coco/arm-cca-guest/rsi-da.c | 42 +++++++++++- drivers/virt/coco/arm-cca-guest/rsi-da.h | 2 + 6 files changed, 137 insertions(+), 1 deletion(-)
arch/arm64/include/asm/rhi.h +13 -0
@@ -49,6 +49,19 @@ unsigned long rhi_get_ipa_change_alignment(void);#define RHI_DA_FEATURES SMC_RHI_CALL(0x004B)#define RHI_DA_VDEV_CONTINUE SMC_RHI_CALL(0x0051) +#define RHI_VDEV_MEASURE_HASH 0x0 +#define RHI_VDEV_MEASURE_RAW 0x1 +struct rhi_vdev_measurement_params { +union { +u64 flags; +u8 padding0[256 ]; + }; +union { +u8 nonce[32 ]; +u8 padding1[256 ]; + }; +}; +#define RHI_DA_VDEV_GET_MEASUREMENTS SMC_RHI_CALL(0x0052)#define RHI_DA_VDEV_GET_INTERFACE_REPORT SMC_RHI_CALL(0x0053)enum rhi_tdi_state {
drivers/virt/coco/arm-cca-guest/arm-cca.c +1 -0
@@ -215,6 +215,7 @@ static struct pci_tsm *cca_tsm_lock(struct tsm_dev *tsm_dev, struct pci_dev *pdeif (ret)return ERR_PTR (ret); +/* collect evidence without nonce */ ret =cca_update_device_object_cache (pdev,NULL );if (ret) {cca_device_unlock (pdev);
drivers/virt/coco/arm-cca-guest/rhi-da.c +79 -0
82 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rhi-da.h +1 -0
@@ -12,4 +12,5 @@ struct pci_dev;bool rhi_has_da_support (void );int rhi_vdev_set_tdi_state (struct pci_dev *pdev,enum rhi_tdi_state target_state);int rhi_update_vdev_interface_report_cache (struct pci_dev *pdev); +int rhi_update_vdev_measurements_cache (struct pci_dev *pdev,const u8 *nonce);#endif
drivers/virt/coco/arm-cca-guest/rsi-da.c +41 -1
58 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rsi-da.h +2 -0
@@ -35,4 +35,6 @@ static inline int rsi_vdev_id(struct pci_dev *pdev)int cca_device_lock (struct pci_dev *pdev);int cca_device_unlock (struct pci_dev *pdev);int cca_update_device_object_cache (struct pci_dev *pdev,const u8 *nonce); +struct page *alloc_shared_pages (int nid,gfp_t gfp_mask,unsigned long min_size); +int free_shared_pages (struct page *page,unsigned long min_size);#endif
Signature · 1 line
2.43.0
RFC PATCH v3 7/11 coco: guest: arm64: Add guest APIs to read host-cached DA objects
In reply to Aneesh Kumar K.V (Arm)Introduce guest-side helpers to read host-cached DA objects (certificate, VCA, interface report, and measurements).
Add RHI_DA_OBJECT_SIZE and RHI_DA_OBJECT_READ definitions, then implement rhi_read_cached_object() that:
- queries object size from host
- validates size against MAX_CACHE_OBJ_SIZE
- allocates a shared buffer
- issues OBJECT_READ into shared memory
- copies data into private memory and frees shared pages
Export the helper for later evidence-collection and verification code.
--- arch/arm64/include/asm/rhi.h | 7 +++ drivers/virt/coco/arm-cca-guest/rhi-da.c | 64 ++++++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rhi-da.h | 1 + drivers/virt/coco/arm-cca-guest/rsi-da.h | 2 + 4 files changed, 74 insertions(+)
arch/arm64/include/asm/rhi.h +7 -0
@@ -48,6 +48,13 @@ unsigned long rhi_get_ipa_change_alignment(void); RHI_DA_FEATURE_VDEV_SET_TDI_STATE)#define RHI_DA_FEATURES SMC_RHI_CALL(0x004B) +#define RHI_DA_OBJECT_CERTIFICATE 0x1 +#define RHI_DA_OBJECT_MEASUREMENT 0x2 +#define RHI_DA_OBJECT_INTERFACE_REPORT 0x3 +#define RHI_DA_OBJECT_VCA 0x4 +#define RHI_DA_OBJECT_SIZE SMC_RHI_CALL(0x004C) +#define RHI_DA_OBJECT_READ SMC_RHI_CALL(0x004D) +#define RHI_DA_VDEV_CONTINUE SMC_RHI_CALL(0x0051)#define RHI_VDEV_MEASURE_HASH 0x0#define RHI_VDEV_MEASURE_RAW 0x1
drivers/virt/coco/arm-cca-guest/rhi-da.c +64 -0
73 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rhi-da.h +1 -0
@@ -13,4 +13,5 @@ bool rhi_has_da_support(void);int rhi_vdev_set_tdi_state (struct pci_dev *pdev,enum rhi_tdi_state target_state);int rhi_update_vdev_interface_report_cache (struct pci_dev *pdev);int rhi_update_vdev_measurements_cache (struct pci_dev *pdev,const u8 *nonce); +int rhi_read_cached_object (int vdev_id,int da_object_type,void **object,int *object_size);#endif
drivers/virt/coco/arm-cca-guest/rsi-da.h +2 -0
@@ -10,6 +10,8 @@#include <linux/pci-tsm.h> #include <asm/rsi_smc.h> +#define MAX_CACHE_OBJ_SIZE SZ_16M +struct cca_guest_dsc {struct pci_tsm_devsec pci; };
Signature · 1 line
2.43.0
RFC PATCH v3 8/11 coco: guest: arm64: Verify DA evidence with RSI_VDEV_GET_INFO digests
In reply to Aneesh Kumar K.V (Arm)Add guest-side evidence verification based on RSI_VDEV_GET_INFO and use the verified TDISP interface report to validate Realm MMIO mappings.
During lock:
- refresh host caches from device
- read certificate/VCA/interface-report/measurement objects from host cache
- fetch trusted digest metadata from RSI_VDEV_GET_INFO
- verify host-provided objects against RSI digests
- initialize and populate PCI TSM evidence objects
- preserve lock/meas/report nonces and digests in guest state
Add mapping helpers to walk MMIO entries from the TDISP report and perform RSI_VDEV_VALIDATE_MAPPING on map, or RIPAS destroy on unmap. Reject malformed range progress while validating.
During unlock:
- invalidate mappings derived from the evidence report
- unlock the device and tear down MMIO bookkeeping
This ensures host-cached DA objects are cryptographically verified before being trusted for mapping and attestation state transitions.
--- arch/arm64/include/asm/rsi_cmds.h | 40 +++ arch/arm64/include/asm/rsi_smc.h | 48 ++++ drivers/virt/coco/arm-cca-guest/Kconfig | 2 + drivers/virt/coco/arm-cca-guest/arm-cca.c | 287 +++++++++++++++++++++- drivers/virt/coco/arm-cca-guest/rsi-da.c | 145 +++++++++++ drivers/virt/coco/arm-cca-guest/rsi-da.h | 22 ++ 6 files changed, 533 insertions(+), 11 deletions(-)
arch/arm64/include/asm/rsi_cmds.h +40 -0
@@ -186,4 +186,44 @@ static inline unsigned long rsi_features(unsigned long index, u64 *out)return res.a0; } +static inline long +rsi_vdev_validate_mapping (unsigned long vdev_id, +phys_addr_t ipa_base,phys_addr_t ipa_top, +phys_addr_t pa_base,phys_addr_t *next_ipa, +unsigned long flags,unsigned long lock_nonce, +unsigned long meas_nonce,unsigned long report_nonce) +{ +struct arm_smccc_1_2_regs res; +struct arm_smccc_1_2_regs regs = { + .a0 =SMC_RSI_VDEV_VALIDATE_MAPPING , + .a1 = vdev_id, + .a2 = ipa_base, + .a3 = ipa_top, + .a4 = pa_base, + .a5 = flags, + .a6 = lock_nonce, + .a7 = meas_nonce, + .a8 = report_nonce, + }; + +arm_smccc_1_2_invoke (®s, &res); + *next_ipa = res.a1; + +if (res.a2 !=RSI_ACCEPT ) +return -EPERM ; + +return res.a0; +} + +static inline unsigned long rsi_vdev_get_info (unsigned long vdev_id, +unsigned long digest_phys) +{ +struct arm_smccc_res res; + +arm_smccc_1_1_invoke (SMC_RSI_VDEV_GET_INFO , + vdev_id, digest_phys, &res); + +return res.a0; +} +#endif /* __ASM_RSI_CMDS_H */
arch/arm64/include/asm/rsi_smc.h +48 -0
60 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/Kconfig +2 -0
@@ -5,6 +5,8 @@ config ARM_CCA_GUEST tristate "Arm CCA Guest driver" depends on ARM64 select PCI_TSM if PCI + select CRYPTO_LIB_SHA256 + select CRYPTO_LIB_SHA512 select TSM_REPORTS select AUXILIARY_BUS help
drivers/virt/coco/arm-cca-guest/arm-cca.c +276 -11
315 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rsi-da.c +145 -0
154 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rsi-da.h +22 -0
@@ -9,11 +9,23 @@#include <linux/pci.h> #include <linux/pci-tsm.h> #include <asm/rsi_smc.h> +#include <crypto/sha2.h> #define MAX_CACHE_OBJ_SIZE SZ_16M +struct dsm_device_info { +u64 lock_nonce; +u64 meas_nonce; +u64 report_nonce; +u8 cert_digest[SHA512_DIGEST_SIZE ]; +u8 vca_digest[SHA512_DIGEST_SIZE ]; +u8 meas_digest[SHA512_DIGEST_SIZE ]; +u8 report_digest[SHA512_DIGEST_SIZE ]; +}; +struct cca_guest_dsc {struct pci_tsm_devsec pci; +struct dsm_device_info dev_info; };static inline struct cca_guest_dsc *to_cca_guest_dsc (struct pci_dev *pdev)
@@ -39,4 +51,14 @@ int cca_device_unlock(struct pci_dev *pdev);int cca_update_device_object_cache (struct pci_dev *pdev,const u8 *nonce);struct page *alloc_shared_pages (int nid,gfp_t gfp_mask,unsigned long min_size);int free_shared_pages (struct page *page,unsigned long min_size); +int cca_map_evidence_report_range (struct pci_dev *pdev,struct pci_tsm_mmio *mmio); +int cca_unmap_evidence_report_range (struct pci_dev *pdev); +int cca_verify_digest (u64 hash_algo,uint8_t *report, +size_t report_size,uint8_t *report_digest); +int cca_verify_digests (u64 hash_algo, +uint8_t *certificate,size_t certificate_size, +uint8_t *vca,size_t vca_size, +uint8_t *interface_report,size_t interface_report_size, +uint8_t *measurements,size_t measurements_size, +struct rsi_vdevice_info *dev_info);#endif
Signature · 1 line
2.43.0
RFC PATCH v3 9/11 coco: guest: arm64: Hook TSM accept to Realm TDISP RUN transition
In reply to Aneesh Kumar K.V (Arm)Add an accept callback in pci_tsm_ops and implement cca_device_accept() to:
- verify evidence generation (lock_nonce)
- allocate and register protected MMIO ranges
- transition TDI state to RUN
--- drivers/virt/coco/arm-cca-guest/arm-cca.c | 20 +++++++++++ drivers/virt/coco/arm-cca-guest/rsi-da.c | 43 +++++++++++++++++++++++ drivers/virt/coco/arm-cca-guest/rsi-da.h | 1 + 3 files changed, 64 insertions(+)
drivers/virt/coco/arm-cca-guest/arm-cca.c +20 -0
@@ -499,9 +499,29 @@ static void cca_tsm_unlock(struct pci_tsm *tsm)kfree (cca_dsc); } +static int __cca_tsm_accept (struct pci_dev *pdev,unsigned long lock_nonce) +{ +int ret; + + ret =cca_device_accept (pdev, lock_nonce); +if (ret) { +pci_err (pdev,"failed to transition the device to run state (%d)\n" , ret); +return ret; + } +return 0 ; +} + +static int cca_tsm_accept (struct pci_dev *pdev) +{ +struct cca_guest_dsc *dsc =to_cca_guest_dsc (pdev); + +return __cca_tsm_accept (pdev, dsc->dev_info.lock_nonce); +} +static struct pci_tsm_ops cca_devsec_pci_ops = { .lock = cca_tsm_lock, .unlock = cca_tsm_unlock, + .accept = cca_tsm_accept, };static void cca_devsec_tsm_remove (void *tsm_dev)
drivers/virt/coco/arm-cca-guest/rsi-da.c +43 -0
46 lines not on this page · raw message
drivers/virt/coco/arm-cca-guest/rsi-da.h +1 -0
@@ -61,4 +61,5 @@ int cca_verify_digests(u64 hash_algo, uint8_t *interface_report, size_t interface_report_size, uint8_t *measurements, size_t measurements_size, struct rsi_vdevice_info *dev_info); +int cca_device_accept (struct pci_dev *pdev,unsigned long lock_nonce);#endif
Signature · 1 line
2.43.0
RFC PATCH v3 10/11 coco: arm64: dma: Update force_dma_unencrypted for accepted devices
In reply to Aneesh Kumar K.V (Arm)This change updates the DMA behavior for accepted devices by assuming they access only private memory. Currently, the DMA API does not provide a mechanism for allocating shared memory that can be accessed by both the secure realm and the non-secure host. Accepted devices are therefore expected to operate entirely within the private memory space.
If future use cases require accepted devices to interact with shared memory— for example, for host-device communication, we will need to extend the DMA interface to support such allocation semantics. This commit lays the groundwork for that by clearly defining the current assumption and isolating the enforcement to force_dma_unencrypted.
Treat swiotlb and decrypted DMA pools as shared-memory paths and avoid them for accepted devices by:
- returning false from is_swiotlb_for_alloc() for accepted devices
- returning false from is_swiotlb_active() for accepted devices
- bypassing dma-direct atomic pool usage for accepted devices
This is based on the current assumption that accepted devices operate on private Realm memory only, and prevents accidental fallback to shared/decrypted DMA backends.
--- arch/arm64/include/asm/mem_encrypt.h | 6 +----- arch/arm64/mm/mem_encrypt.c | 10 ++++++++++ include/linux/swiotlb.h | 3 +++ kernel/dma/direct.c | 8 ++++++++ kernel/dma/swiotlb.c | 3 +++ 5 files changed, 25 insertions(+), 5 deletions(-)
arch/arm64/include/asm/mem_encrypt.h +1 -5
@@ -15,17 +15,13 @@ int arm64_mem_crypt_ops_register(const struct arm64_mem_crypt_ops *ops);int set_memory_encrypted (unsigned long addr,int numpages);int set_memory_decrypted (unsigned long addr,int numpages); +bool force_dma_unencrypted (struct device *dev);#define mem_decrypt_granule_size mem_decrypt_granule_sizesize_t mem_decrypt_granule_size (void );int realm_register_memory_enc_ops (void ); -static inline bool force_dma_unencrypted (struct device *dev) -{ -return is_realm_world (); -} -/* * For Arm CCA guests, canonical addresses are "encrypted", so no changes * required for dma_addr_encrypted().
arch/arm64/mm/mem_encrypt.c +10 -0
@@ -18,6 +18,7 @@#include <linux/err.h> #include <linux/mm.h> #include <linux/mem_encrypt.h> +#include <linux/device.h> static const struct arm64_mem_crypt_ops *crypt_ops;
@@ -67,3 +68,12 @@ size_t mem_decrypt_granule_size(void)return PAGE_SIZE ; }EXPORT_SYMBOL_GPL (mem_decrypt_granule_size); + +bool force_dma_unencrypted (struct device *dev) +{ +if (device_cc_accepted (dev)) +return false; + +return is_realm_world (); +} +EXPORT_SYMBOL_GPL (force_dma_unencrypted);
include/linux/swiotlb.h +3 -0
@@ -296,6 +296,9 @@ bool swiotlb_free(struct device *dev, struct page *page, size_t size);static inline bool is_swiotlb_for_alloc (struct device *dev) { +if (device_cc_accepted (dev)) +return false; +return dev->dma_io_tlb_mem->for_alloc; }#else
kernel/dma/direct.c +8 -0
@@ -158,6 +158,14 @@ static struct page *__dma_direct_alloc_pages(struct device *dev, size_t size,*/ static bool dma_direct_use_pool (struct device *dev,gfp_t gfp) { +/* +* Atomic pools are marked decrypted and are used if we require +* updation of pfn mem encryption attributes or for DMA non-coherent +* device allocation. Both is not true for trusted device. +*/ +if (device_cc_accepted (dev)) +return false; +return !gfpflags_allow_blocking (gfp) && !is_swiotlb_for_alloc (dev); }
kernel/dma/swiotlb.c +3 -0
@@ -1634,6 +1634,9 @@ bool is_swiotlb_active(struct device *dev) {struct io_tlb_mem *mem = dev->dma_io_tlb_mem; +if (device_cc_accepted (dev)) +return false; +return mem && mem->nslabs; }
Signature · 1 line
2.43.0
RFC PATCH v3 11/11 coco: guest: arm64: Enable vdev DMA after attestation
In reply to Aneesh Kumar K.V (Arm)- define SMC_RSI_VDEV_DMA_ENABLE and add wrapper in rsi_cmds.h
- invoke the new helper from the guest accept path once the device passes attestation, rolling back to TDI_LOCKED on failure
--- arch/arm64/include/asm/rsi_cmds.h | 16 ++++++++++++++++ arch/arm64/include/asm/rsi_smc.h | 2 ++ drivers/virt/coco/arm-cca-guest/rsi-da.c | 14 ++++++++++++++ 3 files changed, 32 insertions(+)
arch/arm64/include/asm/rsi_cmds.h +16 -0
@@ -226,4 +226,20 @@ static inline unsigned long rsi_vdev_get_info(unsigned long vdev_id, return res.a0; } +static inline unsigned long __rsi_vdev_dma_enable (unsigned long vdev_id, +unsigned long flags, +unsigned long non_ats_plane, +unsigned long lock_nonce, +unsigned long meas_nonce, +unsigned long report_nonce) +{ +struct arm_smccc_res res; + +arm_smccc_1_1_invoke (SMC_RSI_VDEV_DMA_ENABLE , vdev_id, flags, + non_ats_plane, lock_nonce, + meas_nonce, report_nonce, &res); + +return res.a0; +} +#endif /* __ASM_RSI_CMDS_H */
arch/arm64/include/asm/rsi_smc.h +2 -0
@@ -186,6 +186,8 @@ struct realm_config {*/ #define SMC_RSI_IPA_STATE_GET SMC_RSI_FID(0x198) +#define SMC_RSI_VDEV_DMA_ENABLE SMC_RSI_FID(0x19C) + struct rsi_vdevice_info { union { struct {
drivers/virt/coco/arm-cca-guest/rsi-da.c +14 -0
@@ -231,9 +231,17 @@ int cca_verify_digests(u64 hash_algo,return 0 ; } +static inline int rsi_vdev_enable_dma (int vdev_id,struct dsm_device_info *dev_info) +{ +/* No ATS support */ +return __rsi_vdev_dma_enable (vdev_id,0 ,0 , dev_info->lock_nonce, + dev_info->meas_nonce, dev_info->report_nonce); +} +int cca_device_accept (struct pci_dev *pdev,unsigned long lock_nonce) {int ret; +int vdev_id =rsi_vdev_id (pdev);struct cca_guest_dsc *dsc =to_cca_guest_dsc (pdev);if (lock_nonce != dsc->dev_info.lock_nonce) {
@@ -270,6 +278,12 @@ int cca_device_accept(struct pci_dev *pdev, unsigned long lock_nonce)return ret; } +if (rsi_vdev_enable_dma (vdev_id, &dsc->dev_info)) { +rhi_vdev_set_tdi_state (pdev,RHI_DA_TDI_CONFIG_LOCKED ); +pci_err (pdev,"failed to enable DMA from the device\n" ); +return -EIO ; + } + dsc->pci.mmio =no_free_ptr (tsm_mmio);return 0 ; }
Signature · 1 line
2.43.0