target/s390x: Extend qemu CPACF support
v5 cover target/s390x: Extend qemu CPACF support
This patch series extends the s390 qemu CPACF support to be able to run a subset of the CPACF instruction cross platform. There have been requests on the kernel crypto mailing list about a way to test s390 specific crypto implementations. For example a way to test s390 CPACF exploitation code like the s390_aes.ko kernel module.
So here now is a set of patches verified on x86 and s390 which over (slow but working) support for a subset of the subfunctions of some of the CPACF instructions.
Test: As this series is more or less complete, a full blown linux can be run and the 'usual' in-kernel crpyto modules will be automatically loaded which run a bunch of test cases. So there is now support for these kernel modules:
* sha256_s390x (autoloaded, sha256)
* sha512_s390x (autoloaded, sha512)
* aes_s390x (autoloaded, clear key aes ecb, cbc, ctr, xts)
* pkey_pckmo (autoloaded, derive AES protected key from clear key)
* paes_s390x (not autoloaded, protected key aes ecb, cbc, ctr, xts) All these modules run selftests if configured by the kernel (which is enabled by default). Failures are reported via syslog. Additionally the aes testcases from libica can be run either inside such an qemu environment or with a static build executed with the qemu tcg application qemu-s390x --cpu max <static-build-libica-test>.
Changelog:
v1: Initial version with
- Related code restructured
- Support KIMD SHA512 and thus SHA256
- Support KMC AES-128, AES-192 and AES-256 and thus have basic AES support (ECB mode) enabled.
- Support PCC Compute-XTS-Parameter-AES-128 and Compute-XTS-Parameter-AES-256 but only for block sequence number
0. This is a requirement for the next step:
- Support KM XTS-AES-128 and KM XTS-AES-256. Together with the minimal PCC support this enables AES-XTS CPACF acceleration.
v2: - Basic PCKMO support to be able to 'derive' an AES protected key
from clear key. See header details.
- Support protected key AES-ECB.
- Support protected key AES-CBC.
- Minimal protected key AES-XTS support for CPACF PCC.
- Support protected key AES-XTS.
- Support AES-CTR.
- Support protected key AES-CTR.
v3: - Reordered patches as suggested by Finn.
- One small bug fix in CPACF_aes.c related to address translation.
v4: - Rename of the parameters based on feedback from Janosch to
make clear these are registers or ptrs to registers. Added Tested by from Holger. Fixed typo "face" -> "fake".
v5: - Add documentation file docs/system/s390x/cpacf.rst which
describes the state of the CPACF instructions and which functions are covered when this series is applied. First version sent to public mailing list qemu-s390x.
Harald Freudenberger (15):
target/s390x: Rework s390 cpacf implementations target/s390x: Move cpacf sha512 code into a new file target/s390x: Support cpacf sha256
target/s390x: Support AES ECB for cpacf km instruction target/s390x: Support AES CBC for cpacf kmc instruction target/s390x: Support AES CTR for cpacf kmctr instruction target/s390x: Minimal AES XTS support for cpacf pcc instruction target/s390x: Support AES XTS for cpacf km instruction target/s390x: Support pckmo encrypt AES subfunctions target/s390x: Support protected key AES ECB for cpacf km instruction target/s390x: Support protected key AES CBC for cpacf kmc instruction target/s390x: Support protected key AES CTR for cpacf kmctr
instruction
target/s390x: Minimal protected key AES XTS support for cpacf pcc
instruction
target/s390x: Support protected key AES XTS for cpacf km instruction docs/s390: Document CPACF instructions support
docs/system/s390x/cpacf.rst | 109 ++++ target/s390x/gen-features.c | 31 + target/s390x/tcg/cpacf.h | 59 ++ target/s390x/tcg/cpacf_aes.c | 992 +++++++++++++++++++++++++++++++ target/s390x/tcg/cpacf_sha256.c | 229 +++++++ target/s390x/tcg/cpacf_sha512.c | 241 ++++++++ target/s390x/tcg/crypto_helper.c | 416 +++++++------ target/s390x/tcg/insn-data.h.inc | 1 + target/s390x/tcg/meson.build | 3 + target/s390x/tcg/translate.c | 2 + 10 files changed, 1869 insertions(+), 214 deletions(-) create mode 100644 docs/system/s390x/cpacf.rst create mode 100644 target/s390x/tcg/cpacf.h create mode 100644 target/s390x/tcg/cpacf_aes.c create mode 100644 target/s390x/tcg/cpacf_sha256.c create mode 100644 target/s390x/tcg/cpacf_sha512.c
base-commit: 9c23f2a7b0b45277693a14074b1aaa827eecdb92 --
2.43.0
PATCH v5 1/15 target/s390x: Rework s390 cpacf implementations
Fix missing parts for MSA 9 kdsa and rework the cpacf handling code so that further extensions can be made in a clean and structured way.
--- target/s390x/tcg/crypto_helper.c | 85 ++++++++++++++++++++++++++------ target/s390x/tcg/insn-data.h.inc | 1 + target/s390x/tcg/translate.c | 2 + 3 files changed, 74 insertions(+), 14 deletions(-)
target/s390x/tcg/crypto_helper.c +71 -14
@@ -268,6 +268,57 @@ static void fill_buf_random(CPUS390XState *env, uintptr_t ra, } } +static int cpacf_kimd (CPUS390XState *env,const uintptr_t ra, +uint32_t r1,uint32_t r2,uint32_t r3,uint8_t fc) +{ +int rc =0 ; + +switch (fc) { +case 0x03 :/* CPACF_KIMD_SHA_512 */ + rc =cpacf_sha512 (env, ra, env->regs[1 ], &env->regs[r2], + &env->regs[r2 +1 ],S390_FEAT_TYPE_KIMD ); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} + +static int cpacf_klmd (CPUS390XState *env,const uintptr_t ra, +uint32_t r1,uint32_t r2,uint32_t r3,uint8_t fc) +{ +int rc =0 ; + +switch (fc) { +case 0x03 :/* CPACF_KLMD_SHA_512 */ + rc =cpacf_sha512 (env, ra, env->regs[1 ], &env->regs[r2], + &env->regs[r2 +1 ],S390_FEAT_TYPE_KLMD ); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} + +static int cpacf_ppno (CPUS390XState *env,uintptr_t ra, +uint32_t r1,uint32_t r2,uint32_t r3,uint8_t fc) +{ +int rc =0 ; + +switch (fc) { +case 0x72 :/* CPACF_PRNO_TRNG */ +fill_buf_random (env, ra, &env->regs[r1], &env->regs[r1 +1 ]); +fill_buf_random (env, ra, &env->regs[r2], &env->regs[r2 +1 ]); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} +uint32_t HELPER (msa )(CPUS390XState *env,uint32_t r1,uint32_t r2,uint32_t r3,uint32_t type) {
@@ -276,14 +327,15 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,const uint8_t fc = env->regs[0 ] &0x7fULL ;uint8_t subfunc[16 ] = {0 };uint64_t param_addr; -int i; +int i, rc =0 ;switch (type) { -case S390_FEAT_TYPE_KMAC : +case S390_FEAT_TYPE_KDSA :case S390_FEAT_TYPE_KIMD :case S390_FEAT_TYPE_KLMD : -case S390_FEAT_TYPE_PCKMO : +case S390_FEAT_TYPE_KMAC :case S390_FEAT_TYPE_PCC : +case S390_FEAT_TYPE_PCKMO :if (mod) {tcg_s390_program_interrupt (env,PGM_SPECIFICATION , ra); }
@@ -295,24 +347,29 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,tcg_s390_program_interrupt (env,PGM_SPECIFICATION , ra); } -switch (fc) { -case 0 :/* query subfunction */ -for (i =0 ; i <16 ; i++) { +/* handle query subfunction */ +if (fc ==0 ) { +for (i =0 ; i <sizeof (subfunc); i++) { param_addr =wrap_address (env, env->regs[1 ] + i);cpu_stb_data_ra (env, param_addr, subfunc[i], ra); } + goto out; + } + +switch (type) { +case S390_FEAT_TYPE_KIMD : + rc =cpacf_kimd (env, ra, r1, r2, r3, fc);break ; -case 3 :/* CPACF_*_SHA_512 */ -return cpacf_sha512 (env, ra, env->regs[1 ], &env->regs[r2], - &env->regs[r2 +1 ], type); -case 114 :/* CPACF_PRNO_TRNG */ -fill_buf_random (env, ra, &env->regs[r1], &env->regs[r1 +1 ]); -fill_buf_random (env, ra, &env->regs[r2], &env->regs[r2 +1 ]); +case S390_FEAT_TYPE_KLMD : + rc =cpacf_klmd (env, ra, r1, r2, r3, fc); +break ; +case S390_FEAT_TYPE_PPNO : + rc =cpacf_ppno (env, ra, r1, r2, r3, fc);break ;default : -/* we don't implement any other subfunction yet */ g_assert_not_reached (); } -return 0 ; +out: +return rc; }
target/s390x/tcg/insn-data.h.inc +1 -0
@@ -1012,6 +1012,7 @@ D(0xb92e, KM, RRE, MSA, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_KM) D(0xb92f, KMC, RRE, MSA, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_KMC) D(0xb929, KMA, RRF_b, MSA8, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_KMA) + D(0xb93a, KDSA, RRE, MSA9, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_KDSA) E(0xb93c, PPNO, RRE, MSA5, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_PPNO, IF_IO) D(0xb93e, KIMD, RRE, MSA, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_KIMD) D(0xb93f, KLMD, RRE, MSA, 0, 0, 0, 0, msa, 0, S390_FEAT_TYPE_KLMD)
target/s390x/tcg/translate.c +2 -0
@@ -2564,6 +2564,7 @@ static DisasJumpType op_msa(DisasContext *s, DisasOps *o)/* FALL THROUGH */ case S390_FEAT_TYPE_PCKMO :case S390_FEAT_TYPE_PCC : +case S390_FEAT_TYPE_KDSA :break ;default :g_assert_not_reached ();
@@ -6018,6 +6019,7 @@ enum DisasInsnEnum {#define FAC_MSA4 S390_FEAT_MSA_EXT_4/* msa-extension-4 facility */ #define FAC_MSA5 S390_FEAT_MSA_EXT_5/* msa-extension-5 facility */ #define FAC_MSA8 S390_FEAT_MSA_EXT_8/* msa-extension-8 facility */ +#define FAC_MSA9 S390_FEAT_MSA_EXT_9/* msa-extension-9 facility */ #define FAC_ECT S390_FEAT_EXTRACT_CPU_TIME#define FAC_PCI S390_FEAT_ZPCI/* z/PCI facility */ #define FAC_AIS S390_FEAT_ADAPTER_INT_SUPPRESSION
Signature · 1 line
2.43.0
PATCH v5 2/15 target/s390x: Move cpacf sha512 code into a new file
In reply to Harald FreudenbergerMove the cpacf sha512 implementation into a new file cpacf_sha512.c. Add this new file to the build and add a new header file cpacf.h containing the prototypes for the s390 cpacf stuff.
--- target/s390x/tcg/cpacf.h | 15 ++ target/s390x/tcg/cpacf_sha512.c | 241 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 225 +---------------------------- target/s390x/tcg/meson.build | 1 + 4 files changed, 258 insertions(+), 224 deletions(-) create mode 100644 target/s390x/tcg/cpacf.h create mode 100644 target/s390x/tcg/cpacf_sha512.c
target/s390x/tcg/cpacf.h new file +15 -0
@@ -0,0 +1,15 @@ +/* +* s390x cpacf +* +* This work is licensed under the terms of the GNU GPL, version 2 or later. +* See the COPYING file in the top-level directory. +*/ + +#ifndef S390X_CPACF_H +#define S390X_CPACF_H + +/* from crypto_sha512.c */ +int cpacf_sha512 (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *message_reg,uint64_t *len_reg,uint32_t type); + +#endif
target/s390x/tcg/cpacf_sha512.c new file +241 -0
241 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +1 -224
231 lines not on this page · raw message
target/s390x/tcg/meson.build +1 -0
@@ -1,5 +1,6 @@ s390x_ss.add(when: 'CONFIG_TCG', if_true: files( 'cc_helper.c', + 'cpacf_sha512.c', 'crypto_helper.c', 'excp_helper.c', 'fpu_helper.c',
Signature · 1 line
2.43.0
PATCH v5 3/15 target/s390x: Support cpacf sha256
In reply to Harald FreudenbergerAdd a new file cpacf_sha256.c which implements sha256. Add support for the sha256 subfuction for CPACF kimd and klmd.
--- target/s390x/gen-features.c | 2 + target/s390x/tcg/cpacf.h | 4 + target/s390x/tcg/cpacf_sha256.c | 229 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 8 ++ target/s390x/tcg/meson.build | 1 + 5 files changed, 244 insertions(+) create mode 100644 target/s390x/tcg/cpacf_sha256.c
target/s390x/gen-features.c +2 -0
@@ -916,7 +916,9 @@ static uint16_t qemu_V7_1[] = {*/ static uint16_t qemu_MAX[] = {S390_FEAT_MSA_EXT_5 , +S390_FEAT_KIMD_SHA_256 ,S390_FEAT_KIMD_SHA_512 , +S390_FEAT_KLMD_SHA_256 ,S390_FEAT_KLMD_SHA_512 ,S390_FEAT_PRNO_TRNG , };
target/s390x/tcg/cpacf.h +4 -0
@@ -8,6 +8,10 @@#ifndef S390X_CPACF_H #define S390X_CPACF_H +/* from crypto_sha256.c */ +int cpacf_sha256 (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *message_reg,uint64_t *len_reg,uint32_t type); +/* from crypto_sha512.c */ int cpacf_sha512 (CPUS390XState *env,uintptr_t ra,uint64_t param_addr,uint64_t *message_reg,uint64_t *len_reg,uint32_t type);
target/s390x/tcg/cpacf_sha256.c new file +229 -0
229 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +8 -0
@@ -51,6 +51,10 @@ static int cpacf_kimd(CPUS390XState *env, const uintptr_t ra,int rc =0 ;switch (fc) { +case 0x02 :/* CPACF_KIMD_SHA_256 */ + rc =cpacf_sha256 (env, ra, env->regs[1 ], &env->regs[r2], + &env->regs[r2 +1 ],S390_FEAT_TYPE_KIMD ); +break ;case 0x03 :/* CPACF_KIMD_SHA_512 */ rc =cpacf_sha512 (env, ra, env->regs[1 ], &env->regs[r2], &env->regs[r2 +1 ],S390_FEAT_TYPE_KIMD );
@@ -68,6 +72,10 @@ static int cpacf_klmd(CPUS390XState *env, const uintptr_t ra,int rc =0 ;switch (fc) { +case 0x02 :/* CPACF_KLMD_SHA_256 */ + rc =cpacf_sha256 (env, ra, env->regs[1 ], &env->regs[r2], + &env->regs[r2 +1 ],S390_FEAT_TYPE_KLMD ); +break ;case 0x03 :/* CPACF_KLMD_SHA_512 */ rc =cpacf_sha512 (env, ra, env->regs[1 ], &env->regs[r2], &env->regs[r2 +1 ],S390_FEAT_TYPE_KLMD );
target/s390x/tcg/meson.build +1 -0
@@ -1,5 +1,6 @@ s390x_ss.add(when: 'CONFIG_TCG', if_true: files( 'cc_helper.c', + 'cpacf_sha256.c', 'cpacf_sha512.c', 'crypto_helper.c', 'excp_helper.c',
Signature · 1 line
2.43.0
PATCH v5 4/15 target/s390x: Support AES ECB for cpacf km instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KM_AES_128, CPACF_KM_AES_192 and CPACF_KM_AES_256 for the cpacf km instruction.
--- target/s390x/gen-features.c | 3 + target/s390x/tcg/cpacf.h | 6 ++ target/s390x/tcg/cpacf_aes.c | 110 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 24 +++++++ target/s390x/tcg/meson.build | 1 + 5 files changed, 144 insertions(+) create mode 100644 target/s390x/tcg/cpacf_aes.c
target/s390x/gen-features.c +3 -0
@@ -921,6 +921,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KLMD_SHA_256 ,S390_FEAT_KLMD_SHA_512 ,S390_FEAT_PRNO_TRNG , +S390_FEAT_KM_AES_128 , +S390_FEAT_KM_AES_192 , + S390_FEAT_KM_AES_256, };/****** END FEATURE DEFS ******/
target/s390x/tcg/cpacf.h +6 -0
@@ -16,4 +16,10 @@ int cpacf_sha256(CPUS390XState *env, uintptr_t ra, uint64_t param_addr,int cpacf_sha512 (CPUS390XState *env,uintptr_t ra,uint64_t param_addr,uint64_t *message_reg,uint64_t *len_reg,uint32_t type); +/* from crypto_aes.c */ +int cpacf_aes_ecb (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint32_t type, +uint8_t fc,uint8_t mod); +#endif
target/s390x/tcg/cpacf_aes.c new file +110 -0
110 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +24 -0
@@ -87,6 +87,27 @@ static int cpacf_klmd(CPUS390XState *env, const uintptr_t ra,return rc; } + +static int cpacf_km (CPUS390XState *env,uintptr_t ra,uint32_t r1, +uint32_t r2,uint32_t r3,uint8_t fc,uint8_t mod) +{ +int rc =0 ; + +switch (fc) { +case 0x12 :/* CPACF_KM_AES_128 */ +case 0x13 :/* CPACF_KM_AES_192 */ +case 0x14 :/* CPACF_KM_AES_256 */ + rc =cpacf_aes_ecb (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], +S390_FEAT_TYPE_KM , fc, mod); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} +static int cpacf_ppno (CPUS390XState *env,uintptr_t ra,uint32_t r1,uint32_t r2,uint32_t r3,uint8_t fc) {
@@ -151,6 +172,9 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,case S390_FEAT_TYPE_PPNO : rc =cpacf_ppno (env, ra, r1, r2, r3, fc);break ; +case S390_FEAT_TYPE_KM : + rc =cpacf_km (env, ra, r1, r2, r3, fc, mod); +break ;default :g_assert_not_reached (); }
target/s390x/tcg/meson.build +1 -0
@@ -1,5 +1,6 @@ s390x_ss.add(when: 'CONFIG_TCG', if_true: files( 'cc_helper.c', + 'cpacf_aes.c', 'cpacf_sha256.c', 'cpacf_sha512.c', 'crypto_helper.c',
Signature · 1 line
2.43.0
PATCH v5 5/15 target/s390x: Support AES CBC for cpacf kmc instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KMC_AES_128, CPACF_KMC_AES_192 and CPACF_KMC_AES_256 for the cpacf kmc instruction.
--- target/s390x/gen-features.c | 3 + target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 102 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 23 +++++++ 4 files changed, 132 insertions(+)
target/s390x/gen-features.c +3 -0
@@ -924,6 +924,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KM_AES_128 ,S390_FEAT_KM_AES_192 ,S390_FEAT_KM_AES_256 , +S390_FEAT_KMC_AES_128 , +S390_FEAT_KMC_AES_192 , + S390_FEAT_KMC_AES_256, };/****** END FEATURE DEFS ******/
target/s390x/tcg/cpacf.h +4 -0
@@ -21,5 +21,9 @@ int cpacf_aes_ecb(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_aes_cbc (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint32_t type, +uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +102 -0
105 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +23 -0
@@ -108,6 +108,26 @@ static int cpacf_km(CPUS390XState *env, uintptr_t ra, uint32_t r1,return rc; } +static int cpacf_kmc (CPUS390XState *env,uintptr_t ra,uint32_t r1, +uint32_t r2,uint32_t r3,uint8_t fc,uint8_t mod) +{ +int rc =0 ; + +switch (fc) { +case 0x12 :/* CPACF_KMC_AES_128 */ +case 0x13 :/* CPACF_KMC_AES_192 */ +case 0x14 :/* CPACF_KMC_AES_256 */ + rc =cpacf_aes_cbc (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], +S390_FEAT_TYPE_KMC , fc, mod); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} +static int cpacf_ppno (CPUS390XState *env,uintptr_t ra,uint32_t r1,uint32_t r2,uint32_t r3,uint8_t fc) {
@@ -175,6 +195,9 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,case S390_FEAT_TYPE_KM : rc =cpacf_km (env, ra, r1, r2, r3, fc, mod);break ; +case S390_FEAT_TYPE_KMC : + rc =cpacf_kmc (env, ra, r1, r2, r3, fc, mod); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 6/15 target/s390x: Support AES CTR for cpacf kmctr instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KMCTR_AES_128, CPACF_KMCTR_AES_192 and CPACF_KMCTR_AES_256 for the cpacf kmctr instruction.
--- target/s390x/gen-features.c | 3 ++ target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 74 ++++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 23 ++++++++++ 4 files changed, 104 insertions(+)
target/s390x/gen-features.c +3 -0
@@ -927,6 +927,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KMC_AES_128 ,S390_FEAT_KMC_AES_192 ,S390_FEAT_KMC_AES_256 , +S390_FEAT_KMCTR_AES_128 , +S390_FEAT_KMCTR_AES_192 , + S390_FEAT_KMCTR_AES_256, };/****** END FEATURE DEFS ******/
target/s390x/tcg/cpacf.h +4 -0
@@ -25,5 +25,9 @@ int cpacf_aes_cbc(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_aes_ctr (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint64_t *ctr_ptr_reg, +uint32_t type,uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +74 -0
77 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +23 -0
@@ -128,6 +128,26 @@ static int cpacf_kmc(CPUS390XState *env, uintptr_t ra, uint32_t r1,return rc; } +static int cpacf_kmctr (CPUS390XState *env,uintptr_t ra,uint32_t r1, +uint32_t r2,uint32_t r3,uint8_t fc,uint8_t mod) +{ +int rc =0 ; + +switch (fc) { +case 0x12 :/* CPACF_KMCTR_AES_128 */ +case 0x13 :/* CPACF_KMCTR_AES_192 */ +case 0x14 :/* CPACF_KMCTR_AES_256 */ + rc =cpacf_aes_ctr (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], + &env->regs[r3],S390_FEAT_TYPE_KMCTR , fc, mod); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} +static int cpacf_ppno (CPUS390XState *env,uintptr_t ra,uint32_t r1,uint32_t r2,uint32_t r3,uint8_t fc) {
@@ -198,6 +218,9 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,case S390_FEAT_TYPE_KMC : rc =cpacf_kmc (env, ra, r1, r2, r3, fc, mod);break ; +case S390_FEAT_TYPE_KMCTR : + rc =cpacf_kmctr (env, ra, r1, r2, r3, fc, mod); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 7/15 target/s390x: Minimal AES XTS support for cpacf pcc instruction
In reply to Harald FreudenbergerSupport CPACF pcc subfunctions PCC-Compute-XTS-Parameter-AES-128 and PCC-Compute-XTS-Parameter-AES-128 but only for the special case block sequential number is 0. However, this covers the s390 AES XTS implementation in the Linux kernel and Libica and thus also Opencryptoki clear key via Libica.
--- target/s390x/gen-features.c | 2 + target/s390x/tcg/cpacf.h | 2 + target/s390x/tcg/cpacf_aes.c | 70 ++++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 19 +++++++++ 4 files changed, 93 insertions(+)
target/s390x/gen-features.c +2 -0
@@ -930,6 +930,8 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KMCTR_AES_128 ,S390_FEAT_KMCTR_AES_192 ,S390_FEAT_KMCTR_AES_256 , +S390_FEAT_PCC_XTS_AES_128 , + S390_FEAT_PCC_XTS_AES_256, };/****** END FEATURE DEFS ******/
target/s390x/tcg/cpacf.h +2 -0
@@ -29,5 +29,7 @@ int cpacf_aes_ctr(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint64_t *ctr_ptr_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_aes_pcc (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint8_t fc);#endif
target/s390x/tcg/cpacf_aes.c +70 -0
79 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +19 -0
@@ -165,6 +165,22 @@ static int cpacf_ppno(CPUS390XState *env, uintptr_t ra,return rc; } +static int cpacf_pcc (CPUS390XState *env,uintptr_t ra,uint8_t fc) +{ +int rc =0 ; + +switch (fc) { +case 0x32 :/* CPACF_PCC compute XTS param AES-128 */ +case 0x34 :/* CPACF PCC compute XTS param AES-256 */ + rc =cpacf_aes_pcc (env, ra, env->regs[1 ], fc); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} +uint32_t HELPER (msa )(CPUS390XState *env,uint32_t r1,uint32_t r2,uint32_t r3,uint32_t type) {
@@ -221,6 +237,9 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,case S390_FEAT_TYPE_KMCTR : rc =cpacf_kmctr (env, ra, r1, r2, r3, fc, mod);break ; +case S390_FEAT_TYPE_PCC : + rc =cpacf_pcc (env, ra, fc); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 8/15 target/s390x: Support AES XTS for cpacf km instruction
In reply to Harald FreudenbergerSupport the subfunctions XTS-AES-128 and XTS-AES-256 for the cpacf km instruction.
--- target/s390x/gen-features.c | 2 + target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 105 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 6 ++ 4 files changed, 117 insertions(+)
target/s390x/gen-features.c +2 -0
@@ -924,6 +924,8 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KM_AES_128 ,S390_FEAT_KM_AES_192 ,S390_FEAT_KM_AES_256 , +S390_FEAT_KM_XTS_AES_128 , +S390_FEAT_KM_XTS_AES_256 ,S390_FEAT_KMC_AES_128 ,S390_FEAT_KMC_AES_192 , S390_FEAT_KMC_AES_256,
target/s390x/tcg/cpacf.h +4 -0
@@ -31,5 +31,9 @@ int cpacf_aes_ctr(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint32_t type, uint8_t fc, uint8_t mod);int cpacf_aes_pcc (CPUS390XState *env,uintptr_t ra,uint64_t param_addr,uint8_t fc); +int cpacf_aes_xts (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint32_t type, +uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +105 -0
108 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +6 -0
@@ -101,6 +101,12 @@ static int cpacf_km(CPUS390XState *env, uintptr_t ra, uint32_t r1, &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], S390_FEAT_TYPE_KM, fc, mod);break ; +case 0x32 :/* CPACF_KM_XTS_128 */ +case 0x34 :/* CPACF_KM_XTS_256 */ + rc =cpacf_aes_xts (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], +S390_FEAT_TYPE_KM , fc, mod); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 9/15 target/s390x: Support pckmo encrypt AES subfunctions
In reply to Harald FreudenbergerSupport the subfuctions PCKMO-Encrypt-AES-128-Key, PCKMO-Encrypt-AES-192-Key and PCKMO-Encrypt-AES-256-Key.
These subfunctions derive a protected key from an AES clear key by encrypting it with an internal AES wrapping key. More details can be found in the "z/Architecture Prinziples of Operation" document.
The qemu version provided here is only a fake indented to make protected key available for developing and testing purpose:
* The protected key is 'derived' from the clear key by xoring the fixed pattern 0xAAAA... onto the key value.
* The AES Wrapping Key Verification Pattern is a fixed value of 32 bytes 0xFACEFACE...
--- target/s390x/gen-features.c | 3 ++ target/s390x/tcg/cpacf.h | 2 + target/s390x/tcg/cpacf_aes.c | 65 ++++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 20 ++++++++++ 4 files changed, 90 insertions(+)
target/s390x/gen-features.c +3 -0
@@ -934,6 +934,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KMCTR_AES_256 ,S390_FEAT_PCC_XTS_AES_128 ,S390_FEAT_PCC_XTS_AES_256 , +S390_FEAT_PCKMO_AES_128 , +S390_FEAT_PCKMO_AES_192 , + S390_FEAT_PCKMO_AES_256, };/****** END FEATURE DEFS ******/
target/s390x/tcg/cpacf.h +2 -0
@@ -35,5 +35,7 @@ int cpacf_aes_xts(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_aes_pckmo (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint8_t fc);#endif
target/s390x/tcg/cpacf_aes.c +65 -0
68 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +20 -0
@@ -187,6 +187,23 @@ static int cpacf_pcc(CPUS390XState *env, uintptr_t ra, uint8_t fc)return rc; } +static int cpacf_pckmo (CPUS390XState *env,uintptr_t ra,uint8_t fc) +{ +int rc =0 ; + +switch (fc) { +case 0x12 :/* CPACF_PCKMO_ENC_AES_128_KEY */ +case 0x13 :/* CPACF_PCKMO_ENC_AES_192_KEY */ +case 0x14 :/* CPACF_PCKMO_ENC_AES_256_KEY */ + rc =cpacf_aes_pckmo (env, ra, env->regs[1 ], fc); +break ; +default : +g_assert_not_reached (); + } + +return rc; +} +uint32_t HELPER (msa )(CPUS390XState *env,uint32_t r1,uint32_t r2,uint32_t r3,uint32_t type) {
@@ -246,6 +263,9 @@ uint32_t HELPER(msa)(CPUS390XState *env, uint32_t r1, uint32_t r2, uint32_t r3,case S390_FEAT_TYPE_PCC : rc =cpacf_pcc (env, ra, fc);break ; +case S390_FEAT_TYPE_PCKMO : + rc =cpacf_pckmo (env, ra, fc); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 10/15 target/s390x: Support protected key AES ECB for cpacf km instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KM_PAES_128, CPACF_KM_PAES_192 and CPACF_KM_PAES_256 for the cpacf km instruction.
--- target/s390x/gen-features.c | 3 ++ target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 86 ++++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 7 +++ 4 files changed, 100 insertions(+)
target/s390x/gen-features.c +3 -0
@@ -924,6 +924,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KM_AES_128 ,S390_FEAT_KM_AES_192 ,S390_FEAT_KM_AES_256 , +S390_FEAT_KM_EAES_128 , +S390_FEAT_KM_EAES_192 , +S390_FEAT_KM_EAES_256 ,S390_FEAT_KM_XTS_AES_128 ,S390_FEAT_KM_XTS_AES_256 , S390_FEAT_KMC_AES_128,
target/s390x/tcg/cpacf.h +4 -0
@@ -37,5 +37,9 @@ int cpacf_aes_xts(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint8_t fc, uint8_t mod);int cpacf_aes_pckmo (CPUS390XState *env,uintptr_t ra,uint64_t param_addr,uint8_t fc); +int cpacf_paes_ecb (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint32_t type, +uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +86 -0
89 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +7 -0
@@ -101,6 +101,13 @@ static int cpacf_km(CPUS390XState *env, uintptr_t ra, uint32_t r1, &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], S390_FEAT_TYPE_KM, fc, mod);break ; +case 0x1a :/* CPACF_KM_PAES_128 */ +case 0x1b :/* CPACF_KM_PAES_192 */ +case 0x1c :/* CPACF_KM_PAES_256 */ + rc =cpacf_paes_ecb (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], +S390_FEAT_TYPE_KM , fc, mod); +break ;case 0x32 :/* CPACF_KM_XTS_128 */ case 0x34 :/* CPACF_KM_XTS_256 */ rc = cpacf_aes_xts(env, ra, env->regs[1],
Signature · 1 line
2.43.0
PATCH v5 11/15 target/s390x: Support protected key AES CBC for cpacf kmc instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KMC_PAES_128, CPACF_KMC_PAES_192 and CPACF_KMC_PAES_256 for the cpacf kmc instruction.
--- target/s390x/gen-features.c | 3 + target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 108 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 7 ++ 4 files changed, 122 insertions(+)
target/s390x/gen-features.c +3 -0
@@ -932,6 +932,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KMC_AES_128 ,S390_FEAT_KMC_AES_192 ,S390_FEAT_KMC_AES_256 , +S390_FEAT_KMC_EAES_128 , +S390_FEAT_KMC_EAES_192 , +S390_FEAT_KMC_EAES_256 ,S390_FEAT_KMCTR_AES_128 ,S390_FEAT_KMCTR_AES_192 , S390_FEAT_KMCTR_AES_256,
target/s390x/tcg/cpacf.h +4 -0
@@ -41,5 +41,9 @@ int cpacf_paes_ecb(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_paes_cbc (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint32_t type, +uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +108 -0
111 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +7 -0
@@ -134,6 +134,13 @@ static int cpacf_kmc(CPUS390XState *env, uintptr_t ra, uint32_t r1, &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], S390_FEAT_TYPE_KMC, fc, mod);break ; +case 0x1a :/* CPACF_KMC_PAES_128 */ +case 0x1b :/* CPACF_KMC_PAES_192 */ +case 0x1c :/* CPACF_KMC_PAES_256 */ + rc =cpacf_paes_cbc (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], +S390_FEAT_TYPE_KMC , fc, mod); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 12/15 target/s390x: Support protected key AES CTR for cpacf kmctr instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KMCTR_PAES_128, CPACF_KMCTR_PAES_192 and CPACF_KMCTR_PAES_256 for the cpacf kmctr instruction.
--- target/s390x/gen-features.c | 3 ++ target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 88 ++++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 7 +++ 4 files changed, 102 insertions(+)
target/s390x/gen-features.c +3 -0
@@ -938,6 +938,9 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KMCTR_AES_128 ,S390_FEAT_KMCTR_AES_192 ,S390_FEAT_KMCTR_AES_256 , +S390_FEAT_KMCTR_EAES_128 , +S390_FEAT_KMCTR_EAES_192 , +S390_FEAT_KMCTR_EAES_256 ,S390_FEAT_PCC_XTS_AES_128 ,S390_FEAT_PCC_XTS_AES_256 , S390_FEAT_PCKMO_AES_128,
target/s390x/tcg/cpacf.h +4 -0
@@ -45,5 +45,9 @@ int cpacf_paes_cbc(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_paes_ctr (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint64_t *ctr_ptr_reg, +uint32_t type,uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +88 -0
91 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +7 -0
@@ -161,6 +161,13 @@ static int cpacf_kmctr(CPUS390XState *env, uintptr_t ra, uint32_t r1, &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], &env->regs[r3], S390_FEAT_TYPE_KMCTR, fc, mod);break ; +case 0x1a :/* CPACF_KMCTR_PAES_128 */ +case 0x1b :/* CPACF_KMCTR_PAES_192 */ +case 0x1c :/* CPACF_KMCTR_PAES_256 */ + rc =cpacf_paes_ctr (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], + &env->regs[r3],S390_FEAT_TYPE_KMCTR , fc, mod); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 13/15 target/s390x: Minimal protected key AES XTS support for cpacf pcc instruction
In reply to Harald FreudenbergerSupport CPACF pcc subfunctions PCC-Compute-XTS-Parameter-Encrypted-AES-128 and PCC-Compute-XTS-Parameter-Encrypted-AES-128 but only for the special case block sequential number is 0. However, this covers the s390 PAES XTS implementation in the Linux kernel.
--- target/s390x/gen-features.c | 2 + target/s390x/tcg/cpacf.h | 2 + target/s390x/tcg/cpacf_aes.c | 79 ++++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 4 ++ 4 files changed, 87 insertions(+)
target/s390x/gen-features.c +2 -0
@@ -943,6 +943,8 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KMCTR_EAES_256 ,S390_FEAT_PCC_XTS_AES_128 ,S390_FEAT_PCC_XTS_AES_256 , +S390_FEAT_PCC_XTS_EAES_128 , +S390_FEAT_PCC_XTS_EAES_256 ,S390_FEAT_PCKMO_AES_128 ,S390_FEAT_PCKMO_AES_192 , S390_FEAT_PCKMO_AES_256,
target/s390x/tcg/cpacf.h +2 -0
@@ -49,5 +49,7 @@ int cpacf_paes_ctr(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint64_t *dst_ptr_reg, uint64_t *src_ptr_reg, uint64_t *src_len_reg, uint64_t *ctr_ptr_reg, uint32_t type, uint8_t fc, uint8_t mod); +int cpacf_paes_pcc (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint8_t fc);#endif
target/s390x/tcg/cpacf_aes.c +79 -0
82 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +4 -0
@@ -201,6 +201,10 @@ static int cpacf_pcc(CPUS390XState *env, uintptr_t ra, uint8_t fc)case 0x34 :/* CPACF PCC compute XTS param AES-256 */ rc =cpacf_aes_pcc (env, ra, env->regs[1 ], fc);break ; +case 0x3a :/* CPACF_PCC compute XTS param Encrypted AES-128 */ +case 0x3c :/* CPACF PCC compute XTS param Encrypted AES-256 */ + rc =cpacf_paes_pcc (env, ra, env->regs[1 ], fc); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 14/15 target/s390x: Support protected key AES XTS for cpacf km instruction
In reply to Harald FreudenbergerSupport the subfunctions CPACF_KM_PXTS_128 and CPACF_KM_PAES_256 for the cpacf km instruction.
--- target/s390x/gen-features.c | 2 + target/s390x/tcg/cpacf.h | 4 ++ target/s390x/tcg/cpacf_aes.c | 105 +++++++++++++++++++++++++++++++ target/s390x/tcg/crypto_helper.c | 6 ++ 4 files changed, 117 insertions(+)
target/s390x/gen-features.c +2 -0
@@ -929,6 +929,8 @@ static uint16_t qemu_MAX[] = {S390_FEAT_KM_EAES_256 ,S390_FEAT_KM_XTS_AES_128 ,S390_FEAT_KM_XTS_AES_256 , +S390_FEAT_KM_XTS_EAES_128 , +S390_FEAT_KM_XTS_EAES_256 ,S390_FEAT_KMC_AES_128 ,S390_FEAT_KMC_AES_192 , S390_FEAT_KMC_AES_256,
target/s390x/tcg/cpacf.h +4 -0
@@ -51,5 +51,9 @@ int cpacf_paes_ctr(CPUS390XState *env, uintptr_t ra, uint64_t param_addr, uint32_t type, uint8_t fc, uint8_t mod);int cpacf_paes_pcc (CPUS390XState *env,uintptr_t ra,uint64_t param_addr,uint8_t fc); +int cpacf_paes_xts (CPUS390XState *env,uintptr_t ra,uint64_t param_addr, +uint64_t *dst_ptr_reg,uint64_t *src_ptr_reg, +uint64_t *src_len_reg,uint32_t type, +uint8_t fc,uint8_t mod);#endif
target/s390x/tcg/cpacf_aes.c +105 -0
108 lines not on this page · raw message
target/s390x/tcg/crypto_helper.c +6 -0
@@ -114,6 +114,12 @@ static int cpacf_km(CPUS390XState *env, uintptr_t ra, uint32_t r1, &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], S390_FEAT_TYPE_KM, fc, mod);break ; +case 0x3a :/* CPACF_KM_PXTS_128 */ +case 0x3c :/* CPACF_KM_PXTS_256 */ + rc =cpacf_paes_xts (env, ra, env->regs[1 ], + &env->regs[r1], &env->regs[r2], &env->regs[r2 +1 ], +S390_FEAT_TYPE_KM , fc, mod); +break ;default :g_assert_not_reached (); }
Signature · 1 line
2.43.0
PATCH v5 15/15 docs/s390: Document CPACF instructions support
In reply to Harald FreudenbergerAdd a first document covering the Qemu s390 CPACF instructions and functions supported.
--- docs/system/s390x/cpacf.rst | 109 ++++++++++++++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 docs/system/s390x/cpacf.rst
docs/system/s390x/cpacf.rst new file +109 -0
@@ -0,0 +1,109 @@ +CPACF Support +============= + +CPACF +----- + +CP Assist for Cryptographic Function (CPACF) is a hardware-integrated +coprocessor feature built into every processor core of IBM Z and +LinuxONE mainframes (s390x architecture). It provides high-speed, +hardware-accelerated encryption and hashing directly on the CPU. + +CPACF provides a set of z/Architecture instructions (known as Message +Security Assist or MSA) that execute cryptographic operations +synchronously with the main processor. + +- Symmetric Encryption: Support for AES (128, 192, 256-bit), DES, and + Triple-DES (TDES). +- Hashing: Acceleration for SHA-1, SHA-2 (up to SHA-512), SHA-3 and + SHAKE. +- Random Number Generation: Pseudo Random Number Generator (PRNG) and + a hardware-based True Random Number Generator (TRNG). +- Asymmetric Support: Elliptic Curve Cryptography (ECC) primitives + P-256, P-384, P-521, Montgomery/Edwards curves (e.g., Ed25519). + +CPACF instructions +------------------ + +Here is a list of implemented CPACF instructions and the supported +functions for each instruction: + +KDSA (COMPUTE DIGITAL SIGNATURE AUTHENTICATION) +- Function code 0x00 - Function Query + +KIMD (COMPUTE INTERMEDIATE MESSAGE DIGEST) +- Function code 0x00 - Function Query +- Function code 0x02 - CPACF_KIMD_SHA_256 +- Function code 0x03 - CPACF_KIMD_SHA_512 + +KLMD (COMPUTE LAST MESSAGE DIGEST) +- Function code 0x00 - Function Query +- Function code 0x02 - CPACF_KLMD_SHA_256 +- Function code 0x03 - CPACF_KLMD_SHA_512 + +KM (CIPHER MESSAGE) +- Function code 0x00 - Function Query +- Function code 0x12 - CPACF_KM_AES_128 +- Function code 0x13 - CPACF_KM_AES_192 +- Function code 0x14 - CPACF_KM_AES_256 +- Function code 0x1a - CPACF_KM_PAES_128 +- Function code 0x1b - CPACF_KM_PAES_192 +- Function code 0x1c - CPACF_KM_PAES_256 +- Function code 0x32 - CPACF_KM_XTS_128 +- Function code 0x34 - CPACF_KM_XTS_256 +- Function code 0x3a - CPACF_KM_PXTS_128 +- Function code 0x3c - CPACF_KM_PXTS_256 + +KMAC (COMPUTE MESSAGE AUTHENTICATION CODE) +- Function code 0x00 - Function Query + +KMC (CIPHER MESSAGE WITH CHAINING) +- Function code 0x00 - Function Query +- Function code 0x12 - CPACF_KMC_AES_128 +- Function code 0x13 - CPACF_KMC_AES_192 +- Function code 0x14 - CPACF_KMC_AES_256 +- Function code 0x1a - CPACF_KMC_PAES_128 +- Function code 0x1b - CPACF_KMC_PAES_192 +- Function code 0x1c - CPACF_KMC_PAES_256 + +KMCTR (CIPHER MESSAGE WITH COUNTER) +- Function code 0x00 - Function Query +- Function code 0x12 - CPACF_KMCTR_AES_128 +- Function code 0x13 - CPACF_KMCTR_AES_192 +- Function code 0x14 - CPACF_KMCTR_AES_256 +- Function code 0x1a - CPACF_KMCTR_PAES_128 +- Function code 0x1b - CPACF_KMCTR_PAES_192 +- Function code 0x1c - CPACF_KMCTR_PAES_256 + +KMF (CIPHER MESSAGE WITH CIPHER FEEDBACK) +- not supported + +KMO (CIPHER MESSAGE WITH OUTPUT FEEDBACK) +- not supported + +PCC (PERFORM CRYPTOGRAPHIC COMPUTATION) +- Function code 0x00 - Function Query +- Function code 0x32 - compute XTS param AES-128 +- Function code 0x34 - compute XTS param AES-256 +- Function code 0x3a - compute XTS param Encrypted AES-128 +- Function code 0x3c - compute XTS param Encrypted AES-256 + +PCKMO (PERFORM CRYPTOGRAPHIC KEY MANAGEMENT OPERATION) +- Function code 0x00 - Function Query +- Function code 0x12 - CPACF_PCKMO_ENC_AES_128_KEY +- Function code 0x13 - CPACF_PCKMO_ENC_AES_192_KEY +- Function code 0x14 - CPACF_PCKMO_ENC_AES_256_KEY + +PRNO (PERFORM RANDOM NUMBER OPERATION) +- Function code 0x00 - Function Query +- Function code 0x72 - CPACF_PRNO_TRNG + +Note that the use of a not supported CPACF instruction (KMF and KMO) +or invocation of a not listed function will result in a Specification +Exception. + +Not listed CPACF instructions (KMF, KMO) cause an Operation Exception +when used. Not listed functions cause a Specification Exception when +called. If only the query function is listed (KDSA), then the query +function will return a function status word with all but the query +function bit set to 0.
Signature · 1 line
2.43.0