Function core::arch::riscv32::sm4ks

source Β·
pub unsafe fn sm4ks(rs1: u32, rs2: u32, const BS: u8) -> u32
πŸ”¬This is a nightly-only experimental API. (riscv_ext_intrinsics #114544)
Available on RISC-V RV32 and target feature zksed only.
Expand description

Accelerates the Key Schedule operation of the SM4 block cipher [5, 31] with bs=0.

Implements a T-tables in hardware style approach to accelerating the SM4 Key Schedule. A byte is extracted from rs2 based on bs, to which the SBox and linear layer transforms are applied, before the result is XOR’d with rs1 and written back to rd. This instruction exists on RV32 and RV64 base architectures. On RV64, the 32-bit result is sign extended to XLEN bits. This instruction must always be implemented such that its execution latency does not depend on the data being operated on.

Source: RISC-V Cryptography Extensions Volume I: Scalar & Entropy Source Instructions

Version: v1.0.1

Section: 3.44


The BS parameter is expected to be a constant value and only the bottom 2 bits of bs are used.


This function is safe to use if the zksed target feature is present.


Accelerates the round function F in the SM4 block cipher algorithm

This instruction is included in extension Zksed. It’s defined as:

SM4ED(x, a, BS) = x βŠ• T(ai)
... where
ai = a.bytes[BS]
T(ai) = L(Ο„(ai))
bi = Ο„(ai) = SM4-S-Box(ai)
ci = L(bi) = bi βŠ• (bi β‰ͺ 2) βŠ• (bi β‰ͺ 10) βŠ• (bi β‰ͺ 18) βŠ• (bi β‰ͺ 24)
SM4ED = (ci β‰ͺ (BS * 8)) βŠ• x

where βŠ• represents 32-bit xor, and β‰ͺ k represents rotate left by k bits. As is defined above, T is a combined transformation of non linear S-Box transform Ο„ and linear layer transform L.

In the SM4 algorithm, the round function F is defined as:

F(x0, x1, x2, x3, rk) = x0 βŠ• T(x1 βŠ• x2 βŠ• x3 βŠ• rk)
... where
T(A) = L(Ο„(A))
B = Ο„(A) = (SM4-S-Box(a0), SM4-S-Box(a1), SM4-S-Box(a2), SM4-S-Box(a3))
C = L(B) = B βŠ• (B β‰ͺ 2) βŠ• (B β‰ͺ 10) βŠ• (B β‰ͺ 18) βŠ• (B β‰ͺ 24)

It can be implemented by sm4ed instruction like:

let a = x1 ^ x2 ^ x3 ^ rk;
let c0 = sm4ed(x0, a, 0);
let c1 = sm4ed(c0, a, 1); // c1 represents c[0..=1], etc.
let c2 = sm4ed(c1, a, 2);
let c3 = sm4ed(c2, a, 3);
return c3; // c3 represents c[0..=3]