Basic inline encryption support for ufs-exynos
Subsystems (5)
Eric Biggers
maintainercover Basic inline encryption support for ufs-exynos
Add support for Flash Memory Protector (FMP), which is the inline encryption hardware on Exynos and Exynos-based SoCs.
Specifically, add support for the "traditional FMP mode" that works on many Exynos-based SoCs including gs101. This is the mode that uses "software keys" and is compatible with the upstream kernel's existing inline encryption framework in the block and filesystem layers. I plan to add support for the wrapped key support on gs101 at a later time.
Tested on gs101 (specifically Pixel 6) by running the 'encrypt' group of xfstests on a filesystem mounted with the 'inlinecrypt' mount option.
This patchset applies to v6.10-rc3, and it has no prerequisites that aren't already upstream.
Eric Biggers (6):
scsi: ufs: core: Add UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE
scsi: ufs: core: fold ufshcd_clear_keyslot() into its caller
scsi: ufs: core: Add UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE
scsi: ufs: core: Add fill_crypto_prdt variant op
scsi: ufs: core: Add UFSHCD_QUIRK_KEYS_IN_PRDT
scsi: ufs: exynos: Add support for Flash Memory Protector (FMP)
drivers/ufs/core/ufshcd-crypto.c | 34 +++-- drivers/ufs/core/ufshcd-crypto.h | 36 +++++ drivers/ufs/core/ufshcd.c | 3 +- drivers/ufs/host/ufs-exynos.c | 219 ++++++++++++++++++++++++++++++- include/ufs/ufshcd.h | 28 ++++ 5 files changed, 304 insertions(+), 16 deletions(-)
base-commit: 83a7eefedc9b56fe7bfeff13b6c7356688ffa670
Signature · 1 line
2.45.2
Eric Biggers
maintainerPATCH 1/6 scsi: ufs: core: Add UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE
From: Eric Biggers <[email protected]>
Add UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE which lets UFS host drivers initialize the blk_crypto_profile themselves rather than have it be initialized by ufshcd-core according to the UFSHCI standard. This is needed to support inline encryption on the "Exynos" UFS controller which has a nonstandard interface.
--- drivers/ufs/core/ufshcd-crypto.c | 10 +++++++--- include/ufs/ufshcd.h | 9 +++++++++ 2 files changed, 16 insertions(+), 3 deletions(-)
drivers/ufs/core/ufshcd-crypto.c +7 -3
@@ -157,10 +157,13 @@ int ufshcd_hba_init_crypto_capabilities(struct ufs_hba *hba) {int cap_idx;int err =0 ;enum blk_crypto_mode_num blk_mode_num; +if (hba->quirks &UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE ) +return 0 ; +/* * Don't use crypto if either the hardware doesn't advertise the * standard crypto capability bit *or* if the vendor specific driver * hasn't advertised that crypto is supported. */
@@ -226,13 +229,14 @@ void ufshcd_init_crypto(struct ufs_hba *hba)int slot;if (!(hba->caps &UFSHCD_CAP_CRYPTO ))return ; -/* Clear all keyslots - the number of keyslots is (CFGC + 1) */ -for (slot =0 ; slot < hba->crypto_capabilities.config_count +1 ; slot++) -ufshcd_clear_keyslot (hba, slot); +/* Clear all keyslots. */ +for (slot =0 ; slot < hba->crypto_profile.num_slots; slot++) + hba->crypto_profile.ll_ops.keyslot_evict (&hba->crypto_profile, +NULL , slot); }void ufshcd_crypto_register (struct ufs_hba *hba,struct request_queue *q) {if (hba->caps &UFSHCD_CAP_CRYPTO )
include/ufs/ufshcd.h +9 -0
@@ -641,10 +641,19 @@ enum ufshcd_quirks {/* * Some host does not implement SQ Run Time Command (SQRTC) register * thus need this quirk to skip related flow. */ UFSHCD_QUIRK_MCQ_BROKEN_RTC =1 <<21 , + +/* +* This quirk needs to be enabled if the host controller supports inline +* encryption but it needs to initialize the crypto capabilities in a +* nonstandard way and/or needs to override blk_crypto_ll_ops. If +* enabled, the standard code won't initialize the blk_crypto_profile; +* ufs_hba_variant_ops::init() must do it instead. +*/ + UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE = 1 << 22, };enum ufshcd_caps {/* Allow dynamic clk gating */ UFSHCD_CAP_CLK_GATING = 1 << 0,
base-commit: 83a7eefedc9b56fe7bfeff13b6c7356688ffa670
Signature · 1 line
2.45.2
Eric Biggers
maintainerPATCH 2/6 scsi: ufs: core: fold ufshcd_clear_keyslot() into its caller
In reply to Eric BiggersFrom: Eric Biggers <[email protected]>
Fold ufshcd_clear_keyslot() into its only remaining caller.
--- drivers/ufs/core/ufshcd-crypto.c | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-)
drivers/ufs/core/ufshcd-crypto.c +5 -11
@@ -93,31 +93,25 @@ static int ufshcd_crypto_keyslot_program(struct blk_crypto_profile *profile,memzero_explicit (&cfg,sizeof (cfg));return err; } -static int ufshcd_clear_keyslot (struct ufs_hba *hba,int slot) +static int ufshcd_crypto_keyslot_evict (struct blk_crypto_profile *profile, +const struct blk_crypto_key *key, +unsigned int slot) { +struct ufs_hba *hba = + container_of(profile, struct ufs_hba, crypto_profile);/* * Clear the crypto cfg on the device. Clearing CFGE * might not be sufficient, so just clear the entire cfg. */ union ufs_crypto_cfg_entry cfg = {};return ufshcd_program_key (hba, &cfg, slot); } -static int ufshcd_crypto_keyslot_evict (struct blk_crypto_profile *profile, -const struct blk_crypto_key *key, -unsigned int slot) -{ -struct ufs_hba *hba = - container_of(profile, struct ufs_hba, crypto_profile); - -return ufshcd_clear_keyslot (hba, slot); -} -bool ufshcd_crypto_enable (struct ufs_hba *hba) {if (!(hba->caps &UFSHCD_CAP_CRYPTO ))return false;
Signature · 1 line
2.45.2
Eric Biggers
maintainerPATCH 3/6 scsi: ufs: core: Add UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE
In reply to Eric BiggersFrom: Eric Biggers <[email protected]>
Add UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE which tells the UFS core to not use the crypto enable bit defined by the UFS specification. This is needed to support inline encryption on the "Exynos" UFS controller.
--- drivers/ufs/core/ufshcd-crypto.c | 8 ++++++++ include/ufs/ufshcd.h | 7 +++++++ 2 files changed, 15 insertions(+)
drivers/ufs/core/ufshcd-crypto.c +8 -0
@@ -108,17 +108,25 @@ static int ufshcd_crypto_keyslot_evict(struct blk_crypto_profile *profile,union ufs_crypto_cfg_entry cfg = {};return ufshcd_program_key (hba, &cfg, slot); } +/* +* Reprogram the keyslots if needed, and return true if CRYPTO_GENERAL_ENABLE +* should be used in the host controller initialization sequence. +*/ bool ufshcd_crypto_enable (struct ufs_hba *hba) {if (!(hba->caps &UFSHCD_CAP_CRYPTO ))return false;/* Reset might clear all keys, so reprogram all the keys. */ blk_crypto_reprogram_all_keys (&hba->crypto_profile); + +if (hba->quirks &UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE ) +return false; +return true; }static const struct blk_crypto_ll_ops ufshcd_crypto_ops = { .keyslot_program = ufshcd_crypto_keyslot_program,
include/ufs/ufshcd.h +7 -0
@@ -650,10 +650,17 @@ enum ufshcd_quirks {* nonstandard way and/or needs to override blk_crypto_ll_ops. If * enabled, the standard code won't initialize the blk_crypto_profile; * ufs_hba_variant_ops::init() must do it instead. */ UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE =1 <<22 , + +/* +* This quirk needs to be enabled if the host controller supports inline +* encryption but does not support the CRYPTO_GENERAL_ENABLE bit, i.e. +* host controller initialization fails if that bit is set. +*/ + UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE = 1 << 23, };enum ufshcd_caps {/* Allow dynamic clk gating */ UFSHCD_CAP_CLK_GATING = 1 << 0,
Signature · 1 line
2.45.2
Eric Biggers
maintainerPATCH 4/6 scsi: ufs: core: Add fill_crypto_prdt variant op
In reply to Eric BiggersFrom: Eric Biggers <[email protected]>
Add a variant op to allow host drivers to initialize nonstandard crypto-related fields in the PRDT. This is needed to support inline encryption on the "Exynos" UFS controller.
Note that this will be used together with the support for overriding the PRDT entry size that was already added by commit ada1e653a5ea ("scsi:
ufs: core: Allow UFS host drivers to override the sg entry size").
--- drivers/ufs/core/ufshcd-crypto.h | 19 +++++++++++++++++++ drivers/ufs/core/ufshcd.c | 2 +- include/ufs/ufshcd.h | 4 ++++ 3 files changed, 24 insertions(+), 1 deletion(-)
drivers/ufs/core/ufshcd-crypto.h +19 -0
@@ -35,10 +35,23 @@ ufshcd_prepare_req_desc_hdr_crypto(struct ufshcd_lrb *lrbp, h->cci = lrbp->crypto_key_slot; h->dunl =cpu_to_le32 (lower_32_bits (lrbp->data_unit_num)); h->dunu =cpu_to_le32 (upper_32_bits (lrbp->data_unit_num)); } +static inline int ufshcd_crypto_fill_prdt (struct ufs_hba *hba, +struct ufshcd_lrb *lrbp) +{ +struct scsi_cmnd *cmd = lrbp->cmd; +const struct bio_crypt_ctx *crypt_ctx =scsi_cmd_to_rq (cmd)->crypt_ctx; + +if (crypt_ctx && hba->vops && hba->vops->fill_crypto_prdt) +return hba->vops->fill_crypto_prdt (hba, crypt_ctx, + lrbp->ucd_prdt_ptr, +scsi_sg_count (cmd)); +return 0 ; +} +bool ufshcd_crypto_enable (struct ufs_hba *hba);int ufshcd_hba_init_crypto_capabilities (struct ufs_hba *hba);void ufshcd_init_crypto (struct ufs_hba *hba);
@@ -52,10 +65,16 @@ static inline void ufshcd_prepare_lrbp_crypto(struct request *rq,static inline void ufshcd_prepare_req_desc_hdr_crypto (struct ufshcd_lrb *lrbp,struct request_desc_header *h) { } +static inline int ufshcd_crypto_fill_prdt (struct ufs_hba *hba, +struct ufshcd_lrb *lrbp) +{ +return 0 ; +} +static inline bool ufshcd_crypto_enable (struct ufs_hba *hba) {return false; }
drivers/ufs/core/ufshcd.c +1 -1
@@ -2634,11 +2634,11 @@ static int ufshcd_map_sg(struct ufs_hba *hba, struct ufshcd_lrb *lrbp)if (sg_segments <0 )return sg_segments;ufshcd_sgl_to_prdt (hba, lrbp, sg_segments,scsi_sglist (cmd)); -return 0 ; +return ufshcd_crypto_fill_prdt (hba, lrbp); }/** * ufshcd_enable_intr - enable interrupts * @hba: per adapter instance
include/ufs/ufshcd.h +4 -0
@@ -319,10 +319,11 @@ struct ufs_pwr_mode_info {* @dbg_register_dump: used to dump controller debug information * @phy_initialization: used to initialize phys * @device_reset: called to issue a reset pulse on the UFS device * @config_scaling_param: called to configure clock scaling parameters * @program_key: program or evict an inline encryption key +* @fill_crypto_prdt: initialize crypto-related fields in the PRDT * @event_notify: called to notify important events * @reinit_notify: called to notify reinit of UFSHCD during max gear switch * @mcq_config_resource: called to configure MCQ platform resources * @get_hba_mac: called to get vendor specific mac value, mandatory for mcq mode * @op_runtime_config: called to config Operation and runtime regs Pointers
@@ -363,10 +364,13 @@ struct ufs_hba_variant_ops {void (*config_scaling_param)(struct ufs_hba *hba,struct devfreq_dev_profile *profile,struct devfreq_simple_ondemand_data *data);int (*program_key)(struct ufs_hba *hba,const union ufs_crypto_cfg_entry *cfg,int slot); +int (*fill_crypto_prdt)(struct ufs_hba *hba, +const struct bio_crypt_ctx *crypt_ctx, +void *prdt,unsigned int num_segments);void (*event_notify)(struct ufs_hba *hba,enum ufs_event_type evt,void *data);void (*reinit_notify)(struct ufs_hba *);int (*mcq_config_resource)(struct ufs_hba *hba);int (*get_hba_mac)(struct ufs_hba *hba);
Signature · 1 line
2.45.2
Eric Biggers
maintainerPATCH 5/6 scsi: ufs: core: Add UFSHCD_QUIRK_KEYS_IN_PRDT
In reply to Eric BiggersFrom: Eric Biggers <[email protected]>
Since the nonstandard inline encryption support on Exynos SoCs requires that raw cryptographic keys be copied into the PRDT, it is desirable to zeroize those keys after each request to keep them from being left in memory. Therefore, add a quirk bit that enables the zeroization.
We could instead do the zeroization unconditionally. However, using a quirk bit avoids adding the zeroization overhead to standard devices.
--- drivers/ufs/core/ufshcd-crypto.h | 17 +++++++++++++++++ drivers/ufs/core/ufshcd.c | 1 + include/ufs/ufshcd.h | 8 ++++++++ 3 files changed, 26 insertions(+)
drivers/ufs/core/ufshcd-crypto.h +17 -0
@@ -48,10 +48,24 @@ static inline int ufshcd_crypto_fill_prdt(struct ufs_hba *hba, lrbp->ucd_prdt_ptr, scsi_sg_count(cmd));return 0 ; } +static inline void ufshcd_crypto_clear_prdt (struct ufs_hba *hba, +struct ufshcd_lrb *lrbp) +{ +if (!(hba->quirks &UFSHCD_QUIRK_KEYS_IN_PRDT )) +return ; + +if (!(scsi_cmd_to_rq (lrbp->cmd)->crypt_ctx)) +return ; + +/* Zeroize the PRDT because it can contain cryptographic keys. */ +memzero_explicit (lrbp->ucd_prdt_ptr, +ufshcd_sg_entry_size (hba) *scsi_sg_count (lrbp->cmd)); +} +bool ufshcd_crypto_enable (struct ufs_hba *hba);int ufshcd_hba_init_crypto_capabilities (struct ufs_hba *hba);void ufshcd_init_crypto (struct ufs_hba *hba);
@@ -71,10 +85,13 @@ static inline int ufshcd_crypto_fill_prdt(struct ufs_hba *hba, struct ufshcd_lrb *lrbp) {return 0 ; } +static inline void ufshcd_crypto_clear_prdt (struct ufs_hba *hba, +struct ufshcd_lrb *lrbp) { } +static inline bool ufshcd_crypto_enable (struct ufs_hba *hba) {return false; }
drivers/ufs/core/ufshcd.c +1 -0
@@ -5472,10 +5472,11 @@ void ufshcd_release_scsi_cmd(struct ufs_hba *hba, struct ufshcd_lrb *lrbp) {struct scsi_cmnd *cmd = lrbp->cmd;scsi_dma_unmap (cmd); +ufshcd_crypto_clear_prdt (hba, lrbp);ufshcd_release (hba);ufshcd_clk_scaling_update_busy (hba); }/**
include/ufs/ufshcd.h +8 -0
@@ -661,10 +661,18 @@ enum ufshcd_quirks {* This quirk needs to be enabled if the host controller supports inline * encryption but does not support the CRYPTO_GENERAL_ENABLE bit, i.e. * host controller initialization fails if that bit is set. */ UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE =1 <<23 , + +/* +* This quirk needs to be enabled if the host controller driver copies +* cryptographic keys into the PRDT in order to send them to hardware, +* and therefore the PRDT should be zeroized after each request (as per +* the standard best practice for managing keys). +*/ + UFSHCD_QUIRK_KEYS_IN_PRDT = 1 << 24, };enum ufshcd_caps {/* Allow dynamic clk gating */ UFSHCD_CAP_CLK_GATING = 1 << 0,
Signature · 1 line
2.45.2
Eric Biggers
maintainerPATCH 6/6 scsi: ufs: exynos: Add support for Flash Memory Protector (FMP)
In reply to Eric BiggersFrom: Eric Biggers <[email protected]>
Add support for Flash Memory Protector (FMP), which is the inline encryption hardware on Exynos and Exynos-based SoCs.
Specifically, add support for the "traditional FMP mode" that works on many Exynos-based SoCs including gs101. This is the mode that uses "software keys" and is compatible with the upstream kernel's existing inline encryption framework in the block and filesystem layers. I plan to add support for the wrapped key support on gs101 at a later time.
Tested on gs101 (specifically Pixel 6) by running the 'encrypt' group of xfstests on a filesystem mounted with the 'inlinecrypt' mount option.
--- drivers/ufs/host/ufs-exynos.c | 219 +++++++++++++++++++++++++++++++++- 1 file changed, 218 insertions(+), 1 deletion(-)
drivers/ufs/host/ufs-exynos.c +218 -1
@@ -6,10 +6,13 @@* Author: Seungwon Jeon <[email protected]> * Author: Alim Akhtar <[email protected]> * */ +#include <asm/unaligned.h> +#include <crypto/aes.h> +#include <linux/arm-smccc.h> #include <linux/clk.h> #include <linux/delay.h> #include <linux/module.h> #include <linux/of.h> #include <linux/of_address.h>
@@ -1149,10 +1152,221 @@ static inline void exynos_ufs_priv_init(struct ufs_hba *hba, ufs->rx_sel_idx =0 ; hba->priv = (void *)ufs; hba->quirks = ufs->drv_data->quirks; } +#ifdef CONFIG_SCSI_UFS_CRYPTO + +/* +* Support for Flash Memory Protector (FMP), which is the inline encryption +* hardware on Exynos and Exynos-based SoCs. The interface to this hardware is +* not compatible with the standard UFS crypto. It requires that encryption be +* configured in the PRDT using a nonstandard extension. +*/ + +enum fmp_crypto_algo_mode { +FMP_BYPASS_MODE =0 , +FMP_ALGO_MODE_AES_CBC =1 , +FMP_ALGO_MODE_AES_XTS =2 , +}; +enum fmp_crypto_key_length { +FMP_KEYLEN_256BIT =1 , +}; +#define FMP_DATA_UNIT_SIZE SZ_4K + +/* This is the nonstandard format of PRDT entries when FMP is enabled. */ +struct fmp_sg_entry { + +/* +* This is the standard PRDT entry, but with nonstandard bitfields in +* the high bits of the 'size' field, i.e. the last 32-bit word. When +* these nonstandard bitfields are zero, the data segment won't be +* encrypted or decrypted. Otherwise they specify the algorithm and key +* length with which the data segment will be encrypted or decrypted. +*/ +struct ufshcd_sg_entry base; + +/* The initialization vector (IV) with all bytes reversed */ +__be64 file_iv[2 ]; + +/* +* The key with all bytes reversed. For XTS, the two halves of the key +* are given separately and are byte-reversed separately. +*/ +__be64 file_enckey[4 ]; +__be64 file_twkey[4 ]; + +/* Unused */ +__be64 disk_iv[2 ]; +__be64 reserved[2 ]; +}; + +#define SMC_CMD_FMP_SECURITY 0xC2001810 +#define SMC_CMD_SMU 0xC2001850 +#define SMC_CMD_FMP_SMU_RESUME 0xC2001860 +#define SMU_EMBEDDED 0 +#define SMU_INIT 0 +#define CFG_DESCTYPE_3 3 + +static inline long exynos_smc (unsigned long cmd,unsigned long arg0, +unsigned long arg1,unsigned long arg2) +{ +struct arm_smccc_res res; + +arm_smccc_smc (cmd, arg0, arg1, arg2,0 ,0 ,0 ,0 , &res); +return res.a0; +} + +static void exynos_ufs_fmp_init (struct ufs_hba *hba) +{ +struct blk_crypto_profile *profile = &hba->crypto_profile; +long ret; + +/* +* Check for the standard crypto support bit, since it's available even +* though the rest of the interface to FMP is nonstandard. +* +* This check should have the effect of preventing the driver from +* trying to use FMP on old Exynos SoCs that don't have FMP. +*/ +if (!(ufshcd_readl (hba,REG_CONTROLLER_CAPABILITIES ) & +MASK_CRYPTO_SUPPORT )) +return ; + +/* +* This call (which sets DESCTYPE to 0x3 in the FMPSECURITY0 register) +* is needed to make the hardware use the larger PRDT entry size. +*/ +BUILD_BUG_ON (sizeof (struct fmp_sg_entry ) !=128 ); + ret =exynos_smc (SMC_CMD_FMP_SECURITY ,0 ,SMU_EMBEDDED ,CFG_DESCTYPE_3 ); +if (ret) { +dev_warn (hba->dev, +"SMC_CMD_FMP_SECURITY failed on init: %ld. Disabling FMP support.\n" , + ret); +return ; + } +ufshcd_set_sg_entry_size (hba,sizeof (struct fmp_sg_entry )); + +/* +* This is needed to initialize FMP. Without it, errors occur when +* inline encryption is used. +*/ + ret =exynos_smc (SMC_CMD_SMU ,SMU_INIT ,SMU_EMBEDDED ,0 ); +if (ret) { +dev_err (hba->dev, +"SMC_CMD_SMU(SMU_INIT) failed: %ld. Disabling FMP support.\n" , + ret); +return ; + } + +/* Advertise crypto capabilities to the block layer. */ + ret =devm_blk_crypto_profile_init (hba->dev, profile,0 ); +if (ret) { +/* Only ENOMEM should be possible here. */ +dev_err (hba->dev,"Failed to initialize crypto profile: %ld\n" , + ret); +return ; + } + profile->max_dun_bytes_supported =AES_BLOCK_SIZE ; + profile->dev = hba->dev; + profile->modes_supported[BLK_ENCRYPTION_MODE_AES_256_XTS ] = +FMP_DATA_UNIT_SIZE ; + +/* Advertise crypto support to ufshcd-core. */ + hba->caps |=UFSHCD_CAP_CRYPTO ; + +/* Advertise crypto quirks to ufshcd-core. */ + hba->quirks |=UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE | +UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE | +UFSHCD_QUIRK_KEYS_IN_PRDT ; + +} + +static void exynos_ufs_fmp_resume (struct ufs_hba *hba) +{ +long ret; + + ret =exynos_smc (SMC_CMD_FMP_SECURITY ,0 ,SMU_EMBEDDED ,CFG_DESCTYPE_3 ); +if (ret) +dev_err (hba->dev, +"SMC_CMD_FMP_SECURITY failed on resume: %ld\n" , ret); + + ret =exynos_smc (SMC_CMD_FMP_SMU_RESUME ,0 ,SMU_EMBEDDED ,0 ); +if (ret) +dev_err (hba->dev,"SMC_CMD_FMP_SMU_RESUME failed: %ld\n" , ret); +} + +static inline __be64 fmp_key_word (const u8 *key,int j) +{ +return cpu_to_be64 (get_unaligned_le64 ( + key +AES_KEYSIZE_256 - (j +1 ) *sizeof (u64))); +} + +/* Fill the PRDT for a request according to the given encryption context. */ +static int exynos_ufs_fmp_fill_prdt (struct ufs_hba *hba, +const struct bio_crypt_ctx *crypt_ctx, +void *prdt,unsigned int num_segments) +{ +struct fmp_sg_entry *fmp_prdt = prdt; +const u8 *enckey = crypt_ctx->bc_key->raw; +const u8 *twkey = enckey +AES_KEYSIZE_256 ; +u64 dun_lo = crypt_ctx->bc_dun[0 ]; +u64 dun_hi = crypt_ctx->bc_dun[1 ]; +unsigned int i; + +/* If FMP wasn't enabled, we shouldn't get any encrypted requests. */ +if (WARN_ON_ONCE (!(hba->caps &UFSHCD_CAP_CRYPTO ))) +return -EIO ; + +/* Configure FMP on each segment of the request. */ +for (i =0 ; i < num_segments; i++) { +struct fmp_sg_entry *prd = &fmp_prdt[i]; +int j; + +/* Each segment must be exactly one data unit. */ +if (prd->base.size !=cpu_to_le32 (FMP_DATA_UNIT_SIZE -1 )) { +dev_err (hba->dev, +"data segment is misaligned for FMP\n" ); +return -EIO ; + } + +/* Set the algorithm and key length. */ + prd->base.size |=cpu_to_le32 ((FMP_ALGO_MODE_AES_XTS <<28 ) | + (FMP_KEYLEN_256BIT <<26 )); + +/* Set the IV. */ + prd->file_iv[0 ] =cpu_to_be64 (dun_hi); + prd->file_iv[1 ] =cpu_to_be64 (dun_lo); + +/* Set the key. */ +for (j =0 ; j <AES_KEYSIZE_256 /sizeof (u64); j++) { + prd->file_enckey[j] =fmp_key_word (enckey, j); + prd->file_twkey[j] =fmp_key_word (twkey, j); + } + +/* Increment the data unit number. */ + dun_lo++; +if (dun_lo ==0 ) + dun_hi++; + } +return 0 ; +} + +#else /* CONFIG_SCSI_UFS_CRYPTO */ + +static void exynos_ufs_fmp_init (struct ufs_hba *hba) +{ +} + +static void exynos_ufs_fmp_resume (struct ufs_hba *hba) +{ +} + +#define exynos_ufs_fmp_fill_prdt NULL + +#endif /* !CONFIG_SCSI_UFS_CRYPTO */ +static int exynos_ufs_init (struct ufs_hba *hba) {struct device *dev = hba->dev;struct platform_device *pdev =to_platform_device (dev);struct exynos_ufs *ufs;
@@ -1196,10 +1410,12 @@ static int exynos_ufs_init(struct ufs_hba *hba) goto out; }exynos_ufs_priv_init (hba, ufs); +exynos_ufs_fmp_init (hba); +if (ufs->drv_data->drv_init) { ret = ufs->drv_data->drv_init (dev, ufs);if (ret) {dev_err (dev,"failed to init drv-data\n" ); goto out;
@@ -1430,11 +1646,11 @@ static int exynos_ufs_resume(struct ufs_hba *hba, enum ufs_pm_op pm_op)if (!ufshcd_is_link_active (hba))phy_power_on (ufs->phy);exynos_ufs_config_smu (ufs); - +exynos_ufs_fmp_resume (hba);return 0 ; }static int exynosauto_ufs_vh_link_startup_notify (struct ufs_hba *hba,enum ufs_notify_change_status status)
@@ -1696,10 +1912,11 @@ static const struct ufs_hba_variant_ops ufs_hba_exynos_ops = { .setup_xfer_req = exynos_ufs_specify_nexus_t_xfer_req, .setup_task_mgmt = exynos_ufs_specify_nexus_t_tm_req, .hibern8_notify = exynos_ufs_hibern8_notify, .suspend = exynos_ufs_suspend, .resume = exynos_ufs_resume, + .fill_crypto_prdt = exynos_ufs_fmp_fill_prdt, };static struct ufs_hba_variant_ops ufs_hba_exynosauto_vh_ops = { .name ="exynosauto_ufs_vh" , .init = exynosauto_ufs_vh_init,
Signature · 1 line
2.45.2
Bart Van Assche
reviewerRe: [PATCH 6/6] scsi: ufs: exynos: Add support for Flash Memory Protector (FMP)
Quoted 1 line · Eric Biggers
+#define
FMP_DATA_UNIT_SIZESZ_4K
A Samsung employee told me that the Exynos encryption data unit size is configurable and also that it is set by the following code:
hci_writel(ufs, PRDT_SET_SIZE(12), HCI_TXPRDT_ENTRY_SIZE); hci_writel(ufs, PRDT_SET_SIZE(12), HCI_RXPRDT_ENTRY_SIZE);
How about introducing a new macro that represents the TX PRDT entry size, the RX PRDT entry size and the encryption data unit size?
Thanks,
Bart.
Eric Biggers
maintainerRe: [PATCH 6/6] scsi: ufs: exynos: Add support for Flash Memory Protector (FMP)
Quoted 12 lines · Bart Van Assche
Quoted 1 line · Eric Biggers
+#define
FMP_DATA_UNIT_SIZESZ_4KA Samsung employee told me that the Exynos encryption data unit size is configurable and also that it is set by the following code:
hci_writel(ufs, PRDT_SET_SIZE(12), HCI_TXPRDT_ENTRY_SIZE); hci_writel(ufs, PRDT_SET_SIZE(12), HCI_RXPRDT_ENTRY_SIZE);How about introducing a new macro that represents the TX PRDT entry size, the RX PRDT entry size and the encryption data unit size?
Done in v2.
- Eric
Re: [PATCH 6/6] scsi: ufs: exynos: Add support for Flash Memory Protector (FMP)
In reply to Eric BiggersQuoted 63 lines · Eric Biggers
From: Eric Biggers <[email protected]>
Add support for Flash Memory Protector (FMP), which is the inline encryption hardware on Exynos and Exynos-based SoCs.
Specifically, add support for the "traditional FMP mode" that works on many Exynos-based SoCs including gs101. This is the mode that uses "software keys" and is compatible with the upstream kernel's existing inline encryption framework in the block and filesystem layers. I plan to add support for the wrapped key support on gs101 at a later time.
Tested on gs101 (specifically Pixel 6) by running the 'encrypt' group of xfstests on a filesystem mounted with the 'inlinecrypt' mount option.
Signed-off-by Eric Biggers <[email protected]>--- drivers/ufs/host/ufs-exynos.c | 219 +++++++++++++++++++++++++++++++++- 1 file changed, 218 insertions(+), 1 deletion(-)drivers/ufs/host/ufs-exynos.c +22
-0@@ -6,10 +6,13 @@* Author: Seungwon Jeon <[email protected]> * Author: Alim Akhtar <[email protected]> * */ +#include <asm/unaligned.h> +#include <crypto/aes.h> +#include <linux/arm-smccc.h> #include <linux/clk.h> #include <linux/delay.h> #include <linux/module.h> #include <linux/of.h> #include <linux/of_address.h> @@ -1149,10 +1152,221 @@ static inline void exynos_ufs_priv_init(struct ufs_hba *hba, ufs->rx_sel_idx =0 ; hba->priv = (void *)ufs; hba->quirks = ufs->drv_data->quirks; } +#ifdef CONFIG_SCSI_UFS_CRYPTO + +/* +* Support for Flash Memory Protector (FMP), which is the inline encryption +* hardware on Exynos and Exynos-based SoCs. The interface to this hardware is +* not compatible with the standard UFS crypto. It requires that encryption be +* configured in the PRDT using a nonstandard extension. +*/ + +enum fmp_crypto_algo_mode { +FMP_BYPASS_MODE =0 , +FMP_ALGO_MODE_AES_CBC =1 , +FMP_ALGO_MODE_AES_XTS =2 , +}; +enum fmp_crypto_key_length { +FMP_KEYLEN_256BIT =1 , +}; +#define FMP_DATA_UNIT_SIZE SZ_4K +
drivers/ufs/host/ufs-exynos.c static inline void exynos_ufs_priv_init(struct ufs_hba *hba, · line 1185
Quoted 10 lines
drivers/ufs/host/ufs-exynos.c +10
-0+/* This is the nonstandard format of PRDT entries when FMP is enabled. */ +struct fmp_sg_entry { + +/* +* This is the standard PRDT entry, but with nonstandard bitfields in +* the high bits of the 'size' field, i.e. the last 32-bit word. When +* these nonstandard bitfields are zero, the data segment won't be +* encrypted or decrypted. Otherwise they specify the algorithm and key +* length with which the data segment will be encrypted or decrypted. +*/
Minor suggestion: create a kernel-doc comment for the structure and pull all fields documentation there.
Quoted 10 lines
drivers/ufs/host/ufs-exynos.c +10
-0+struct ufshcd_sg_entry base; + +/* The initialization vector (IV) with all bytes reversed */ +__be64 file_iv[2 ]; + +/* +* The key with all bytes reversed. For XTS, the two halves of the key +* are given separately and are byte-reversed separately. +*/ +__be64 file_enckey[4 ];
drivers/ufs/host/ufs-exynos.c static inline void exynos_ufs_priv_init(struct ufs_hba *hba, · line 1205
Quoted 10 lines
drivers/ufs/host/ufs-exynos.c +10
-0+__be64 file_twkey[4 ]; + +/* Unused */ +__be64 disk_iv[2 ]; +__be64 reserved[2 ]; +}; + +#define SMC_CMD_FMP_SECURITY 0xC2001810 +#define SMC_CMD_SMU 0xC2001850 +#define SMC_CMD_FMP_SMU_RESUME 0xC2001860
Suggest to use ARM_SMCCC_CALL_VAL() macro to define above values.
drivers/ufs/host/ufs-exynos.c static inline void exynos_ufs_priv_init(struct ufs_hba *hba, · line 1217
Quoted 12 lines
drivers/ufs/host/ufs-exynos.c +12
-0+#define SMU_EMBEDDED 0 +#define SMU_INIT 0 +#define CFG_DESCTYPE_3 3 + +static inline long exynos_smc (unsigned long cmd,unsigned long arg0, +unsigned long arg1,unsigned long arg2) +{ +struct arm_smccc_res res; + +arm_smccc_smc (cmd, arg0, arg1, arg2,0 ,0 ,0 ,0 , &res); +return res.a0; +}
This wrapper looks like it was borrowed from the downstream Samsung code. Not sure if it brings any value nowadays. Maybe it would be clearer to just use arm_smccc_smc() directly and remove this wrapper?
Quoted 197 lines
drivers/ufs/host/ufs-exynos.c +154
-2+ +static void exynos_ufs_fmp_init (struct ufs_hba *hba) +{ +struct blk_crypto_profile *profile = &hba->crypto_profile; +long ret; + +/* +* Check for the standard crypto support bit, since it's available even +* though the rest of the interface to FMP is nonstandard. +* +* This check should have the effect of preventing the driver from +* trying to use FMP on old Exynos SoCs that don't have FMP. +*/ +if (!(ufshcd_readl (hba,REG_CONTROLLER_CAPABILITIES ) & +MASK_CRYPTO_SUPPORT )) +return ; + +/* +* This call (which sets DESCTYPE to 0x3 in the FMPSECURITY0 register) +* is needed to make the hardware use the larger PRDT entry size. +*/ +BUILD_BUG_ON (sizeof (struct fmp_sg_entry ) !=128 ); + ret =exynos_smc (SMC_CMD_FMP_SECURITY ,0 ,SMU_EMBEDDED ,CFG_DESCTYPE_3 ); +if (ret) { +dev_warn (hba->dev, +"SMC_CMD_FMP_SECURITY failed on init: %ld. Disabling FMP support.\n" , + ret); +return ; + } +ufshcd_set_sg_entry_size (hba,sizeof (struct fmp_sg_entry )); + +/* +* This is needed to initialize FMP. Without it, errors occur when +* inline encryption is used. +*/ + ret =exynos_smc (SMC_CMD_SMU ,SMU_INIT ,SMU_EMBEDDED ,0 ); +if (ret) { +dev_err (hba->dev, +"SMC_CMD_SMU(SMU_INIT) failed: %ld. Disabling FMP support.\n" , + ret); +return ; + } + +/* Advertise crypto capabilities to the block layer. */ + ret =devm_blk_crypto_profile_init (hba->dev, profile,0 ); +if (ret) { +/* Only ENOMEM should be possible here. */ +dev_err (hba->dev,"Failed to initialize crypto profile: %ld\n" , + ret); +return ; + } + profile->max_dun_bytes_supported =AES_BLOCK_SIZE ; + profile->dev = hba->dev; + profile->modes_supported[BLK_ENCRYPTION_MODE_AES_256_XTS ] = +FMP_DATA_UNIT_SIZE ; + +/* Advertise crypto support to ufshcd-core. */ + hba->caps |=UFSHCD_CAP_CRYPTO ; + +/* Advertise crypto quirks to ufshcd-core. */ + hba->quirks |=UFSHCD_QUIRK_CUSTOM_CRYPTO_PROFILE | +UFSHCD_QUIRK_BROKEN_CRYPTO_ENABLE | +UFSHCD_QUIRK_KEYS_IN_PRDT ; + +} + +static void exynos_ufs_fmp_resume (struct ufs_hba *hba) +{ +long ret; + + ret =exynos_smc (SMC_CMD_FMP_SECURITY ,0 ,SMU_EMBEDDED ,CFG_DESCTYPE_3 ); +if (ret) +dev_err (hba->dev, +"SMC_CMD_FMP_SECURITY failed on resume: %ld\n" , ret); + + ret =exynos_smc (SMC_CMD_FMP_SMU_RESUME ,0 ,SMU_EMBEDDED ,0 ); +if (ret) +dev_err (hba->dev,"SMC_CMD_FMP_SMU_RESUME failed: %ld\n" , ret); +} + +static inline __be64 fmp_key_word (const u8 *key,int j) +{ +return cpu_to_be64 (get_unaligned_le64 ( + key +AES_KEYSIZE_256 - (j +1 ) *sizeof (u64))); +} + +/* Fill the PRDT for a request according to the given encryption context. */ +static int exynos_ufs_fmp_fill_prdt (struct ufs_hba *hba, +const struct bio_crypt_ctx *crypt_ctx, +void *prdt,unsigned int num_segments) +{ +struct fmp_sg_entry *fmp_prdt = prdt; +const u8 *enckey = crypt_ctx->bc_key->raw; +const u8 *twkey = enckey +AES_KEYSIZE_256 ; +u64 dun_lo = crypt_ctx->bc_dun[0 ]; +u64 dun_hi = crypt_ctx->bc_dun[1 ]; +unsigned int i; + +/* If FMP wasn't enabled, we shouldn't get any encrypted requests. */ +if (WARN_ON_ONCE (!(hba->caps &UFSHCD_CAP_CRYPTO ))) +return -EIO ; + +/* Configure FMP on each segment of the request. */ +for (i =0 ; i < num_segments; i++) { +struct fmp_sg_entry *prd = &fmp_prdt[i]; +int j; + +/* Each segment must be exactly one data unit. */ +if (prd->base.size !=cpu_to_le32 (FMP_DATA_UNIT_SIZE -1 )) { +dev_err (hba->dev, +"data segment is misaligned for FMP\n" ); +return -EIO ; + } + +/* Set the algorithm and key length. */ + prd->base.size |=cpu_to_le32 ((FMP_ALGO_MODE_AES_XTS <<28 ) | + (FMP_KEYLEN_256BIT <<26 )); + +/* Set the IV. */ + prd->file_iv[0 ] =cpu_to_be64 (dun_hi); + prd->file_iv[1 ] =cpu_to_be64 (dun_lo); + +/* Set the key. */ +for (j =0 ; j <AES_KEYSIZE_256 /sizeof (u64); j++) { + prd->file_enckey[j] =fmp_key_word (enckey, j); + prd->file_twkey[j] =fmp_key_word (twkey, j); + } + +/* Increment the data unit number. */ + dun_lo++; +if (dun_lo ==0 ) + dun_hi++; + } +return 0 ; +} + +#else /* CONFIG_SCSI_UFS_CRYPTO */ + +static void exynos_ufs_fmp_init (struct ufs_hba *hba) +{ +} + +static void exynos_ufs_fmp_resume (struct ufs_hba *hba) +{ +} + +#define exynos_ufs_fmp_fill_prdt NULL + +#endif /* !CONFIG_SCSI_UFS_CRYPTO */ +static int exynos_ufs_init (struct ufs_hba *hba) {struct device *dev = hba->dev;struct platform_device *pdev =to_platform_device (dev);struct exynos_ufs *ufs;@@ -1196,10 +1410,12 @@ static int exynos_ufs_init(struct ufs_hba *hba) goto out; }exynos_ufs_priv_init (hba, ufs); +exynos_ufs_fmp_init (hba); +if (ufs->drv_data->drv_init) { ret = ufs->drv_data->drv_init (dev, ufs);if (ret) {dev_err (dev,"failed to init drv-data\n" ); goto out;@@ -1430,11 +1646,11 @@ static int exynos_ufs_resume(struct ufs_hba *hba, enum ufs_pm_op pm_op)if (!ufshcd_is_link_active (hba))phy_power_on (ufs->phy);exynos_ufs_config_smu (ufs); - +exynos_ufs_fmp_resume (hba);return 0 ; }static int exynosauto_ufs_vh_link_startup_notify (struct ufs_hba *hba,enum ufs_notify_change_status status)@@ -1696,10 +1912,11 @@ static const struct ufs_hba_variant_ops ufs_hba_exynos_ops = { .setup_xfer_req = exynos_ufs_specify_nexus_t_xfer_req, .setup_task_mgmt = exynos_ufs_specify_nexus_t_tm_req, .hibern8_notify = exynos_ufs_hibern8_notify, .suspend = exynos_ufs_suspend, .resume = exynos_ufs_resume, + .fill_crypto_prdt = exynos_ufs_fmp_fill_prdt, };static struct ufs_hba_variant_ops ufs_hba_exynosauto_vh_ops = { .name ="exynosauto_ufs_vh" , .init = exynosauto_ufs_vh_init, --2.45.2
Eric Biggers
maintainerRe: [PATCH 6/6] scsi: ufs: exynos: Add support for Flash Memory Protector (FMP)
Quoted 101 lines · Sam Protsenko
Quoted 63 lines · Eric Biggers
From: Eric Biggers <[email protected]>
Add support for Flash Memory Protector (FMP), which is the inline encryption hardware on Exynos and Exynos-based SoCs.
Specifically, add support for the "traditional FMP mode" that works on many Exynos-based SoCs including gs101. This is the mode that uses "software keys" and is compatible with the upstream kernel's existing inline encryption framework in the block and filesystem layers. I plan to add support for the wrapped key support on gs101 at a later time.
Tested on gs101 (specifically Pixel 6) by running the 'encrypt' group of xfstests on a filesystem mounted with the 'inlinecrypt' mount option.
Signed-off-by Eric Biggers <[email protected]>--- drivers/ufs/host/ufs-exynos.c | 219 +++++++++++++++++++++++++++++++++- 1 file changed, 218 insertions(+), 1 deletion(-)drivers/ufs/host/ufs-exynos.c +22
-0@@ -6,10 +6,13 @@* Author: Seungwon Jeon <[email protected]> * Author: Alim Akhtar <[email protected]> * */ +#include <asm/unaligned.h> +#include <crypto/aes.h> +#include <linux/arm-smccc.h> #include <linux/clk.h> #include <linux/delay.h> #include <linux/module.h> #include <linux/of.h> #include <linux/of_address.h> @@ -1149,10 +1152,221 @@ static inline void exynos_ufs_priv_init(struct ufs_hba *hba, ufs->rx_sel_idx =0 ; hba->priv = (void *)ufs; hba->quirks = ufs->drv_data->quirks; } +#ifdef CONFIG_SCSI_UFS_CRYPTO + +/* +* Support for Flash Memory Protector (FMP), which is the inline encryption +* hardware on Exynos and Exynos-based SoCs. The interface to this hardware is +* not compatible with the standard UFS crypto. It requires that encryption be +* configured in the PRDT using a nonstandard extension. +*/ + +enum fmp_crypto_algo_mode { +FMP_BYPASS_MODE =0 , +FMP_ALGO_MODE_AES_CBC =1 , +FMP_ALGO_MODE_AES_XTS =2 , +}; +enum fmp_crypto_key_length { +FMP_KEYLEN_256BIT =1 , +}; +#define FMP_DATA_UNIT_SIZE SZ_4K +drivers/ufs/host/ufs-exynos.c static inline void exynos_ufs_priv_init(struct ufs_hba *hba, · line 1185
Quoted 10 lines
drivers/ufs/host/ufs-exynos.c +10
-0+/* This is the nonstandard format of PRDT entries when FMP is enabled. */ +struct fmp_sg_entry { + +/* +* This is the standard PRDT entry, but with nonstandard bitfields in +* the high bits of the 'size' field, i.e. the last 32-bit word. When +* these nonstandard bitfields are zero, the data segment won't be +* encrypted or decrypted. Otherwise they specify the algorithm and key +* length with which the data segment will be encrypted or decrypted. +*/ Minor suggestion: create a kernel-doc comment for the structure and pull all fields documentation there.
Quoted 10 lines
drivers/ufs/host/ufs-exynos.c +10
-0+struct ufshcd_sg_entry base; + +/* The initialization vector (IV) with all bytes reversed */ +__be64 file_iv[2 ]; + +/* +* The key with all bytes reversed. For XTS, the two halves of the key +* are given separately and are byte-reversed separately. +*/ +__be64 file_enckey[4 ];drivers/ufs/host/ufs-exynos.c static inline void exynos_ufs_priv_init(struct ufs_hba *hba, · line 1205
Quoted 10 lines
drivers/ufs/host/ufs-exynos.c +10
-0+__be64 file_twkey[4 ]; + +/* Unused */ +__be64 disk_iv[2 ]; +__be64 reserved[2 ]; +}; + +#define SMC_CMD_FMP_SECURITY 0xC2001810 +#define SMC_CMD_SMU 0xC2001850 +#define SMC_CMD_FMP_SMU_RESUME 0xC2001860Suggest to use
ARM_SMCCC_CALL_VAL()macro to define above values.
Quoted 17 lines
drivers/ufs/host/ufs-exynos.c static inline void exynos_ufs_priv_init(struct ufs_hba *hba, · line 1217
Quoted 12 lines
drivers/ufs/host/ufs-exynos.c +12
-0+#define SMU_EMBEDDED 0 +#define SMU_INIT 0 +#define CFG_DESCTYPE_3 3 + +static inline long exynos_smc (unsigned long cmd,unsigned long arg0, +unsigned long arg1,unsigned long arg2) +{ +struct arm_smccc_res res; + +arm_smccc_smc (cmd, arg0, arg1, arg2,0 ,0 ,0 ,0 , &res); +return res.a0; +}This wrapper looks like it was borrowed from the downstream Samsung code. Not sure if it brings any value nowadays. Maybe it would be clearer to just use
arm_smccc_smc()directly and remove this wrapper?
All done in v2. Thanks.
- Eric