mbx_exp/1024/2048/3072/4096_mb8¶
Performs modular exponentiation.
Syntax¶
mbx_status mbx_exp1024_mb8(int64u* const out_pa[8], const int64u* const base_pa[8], const int64u* const exp_pa[8], int exp_bits, const int64u* const mod_pa[8], int mod_bits, int8u* pBuffer, int bufferLen);
mbx_status mbx_exp2048_mb8(int64u* const out_pa[8], const int64u* const base_pa[8], const int64u* const exp_pa[8], int exp_bits, const int64u* const mod_pa[8], int mod_bits, int8u* pBuffer, int bufferLen);
mbx_status mbx_exp3072_mb8(int64u* const out_pa[8], const int64u* const base_pa[8], const int64u* const exp_pa[8], int exp_bits, const int64u* const mod_pa[8], int mod_bits, int8u* pBuffer, int bufferLen);
mbx_status mbx_exp4096_mb8(int64u* const out_pa[8], const int64u* const base_pa[8], const int64u* const exp_pa[8], int exp_bits, const int64u* const mod_pa[8], int mod_bits, int8u* pBuffer, int bufferLen);
mbx_status mbx_exp_mb8(int64u* const out_pa[8], const int64u* const base_pa[8], const int64u* const exp_pa[8], int exp_bits, const int64u* const mod_pa[8], int mod_bits, int8u* pBuffer, int bufferLen);
Include Files¶
crypto_mb/exp.h
Parameters¶
out_pa |
Array of pointers to the computed exponents. |
base_pa |
Array of pointers to the input bases to be exponentiated. |
exp_pa |
Array of pointers to the input power values. |
exp_bits |
Size of power in bits. |
mod_pa |
Array of pointers to the input modules used for reduction. |
mod_bits |
Size of modulus in bits. |
pBuffer |
Pointer to the work buffer. |
bufferLen |
Size of the work buffer in bytes. |
Description¶
All the functions compute modular exponentiation by the following formula:
Functions mbx_exp1024_mb8, mbx_exp2048_mb8, mbx_exp3072_mb8, and mbx_exp4096_mb8 are focused on exponentiation over the limited range of modulus n[i] - 1Kb, 2Kb, 3Kb, and 4Kb correspondingly.
Exact ranges of supported modulus are represented in the table below.
function name |
modulus range |
exact boundaries (min, max) of the modulus size in bits |
|---|---|---|
mbx_exp1024_mb8 |
1Kb |
989, 1038 |
mbx_exp2048_mb8 |
2Kb |
2029, 2078 |
mbx_exp3072_mb8 |
3Kb |
3069, 3118 |
mbx_exp4096_mb8 |
4Kb |
4057, 4106 |
If actual sizes of modules are different, set the mod_bits parameter equal to maximum size of the actual module in bit size and extend all the modules with zero bits to the mod_bits value. The same is applicable for the exp_bits parameter and actual exponents.
The mbx_exp_mb8 function provides processing of modules belonging to either 1Kb, 2Kb, 3Kb or 4Kb range only, calling appropriate mbx_exp1024_mb8, mbx_exp2048_mb8, mbx_exp3072_mb8 or mbx_exp4096_mb8 function based on mod_bits parameter.
Parameters pBuffer and bufferLen are defining the work buffer used for internal purposes. Minimal size of the work buffer necessary for performing modular exponentiation can be obtained by the call of the mbx_exp_BufferSize function.
Return Values¶
The mbx_exp1024_mb8, mbx_exp2048_mb8, mbx_exp3072_mb8, mbx_exp4096_mb8, and mbx_exp_mb8 functions return the status that indicates whether the operation completed successfully or not. The status value of 0 indicates that all operations completed successfully. The error condition can be analyzed by the MBX_GET_STS() call.