Developer Reference

Contents

RSA_InitPublicKey, RSA_InitPrivateKeyType1, RSA_InitPrivateKeyType2

Initialize user-supplied memory as the
IppsRSAPublicKeyState
or
IppsRSAPrivateKeyState
context for future use.

Syntax

IppStatus ippsRSA_InitPublicKey(int
rsaModulusBitSize
, int
publicExpBitSize
, IppsRSAPublicKeyState*
pKey
, int
keyCtxSize
);
IppStatus ippsRSA_InitPrivateKeyType1(int
rsaModulusBitSize
, int
privateExpBitSize
, IppsRSAPrivateKeyState*
pKey
, int
keyCtxSize
);
IppStatus ippsRSA_InitPrivateKeyType2(int
factorPBitSize
, int
FactorQBitSize
, IppsRSAPrivateKeyState*
pKey
, int
keyCtxSize
);
Include Files
ippcp.h
Parameters
rsaModulusBitSize
Length of the RSA system in bits (that is, the length of the composite RSA modulus n in bits).
publicExpBitSize
Length of the RSA public exponent in bits (that is, the length of the
e
component of the RSA public key).
privateExpBitSize
Length of the RSA private exponent in bits (that is, the length of the
d
component of the type 1 RSA private key).
factorPBitSize
,
FactorQBitSize
Length in bits of the
p
and
q
factors of the RSA modulus
n
=
p
*
q
.
pKey
Pointer to the
IppsRSAPublicKeyState
or
IppsRSAPrivateKeyState
context being initialized. The context depends on the function.
keyCtxSize
Available size in bytes of the memory buffer being initialized.
Description
These functions initialize the memory pointed by
pKey
as the
IppsRSAPublicKeyState
or
IppsRSAPrivateKeyState
context, depending on the function. To determine the size of the memory buffer, call the appropriate
RSA_GetSizePublicKey
,
RSA_GetSizePrivateKeyType1
,
RSA_GetSizePrivateKeyType2
function prior to calling any of these functions.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if any of the specified pointers is
NULL
.
ippStsNotSupportedModeErr
Indicates an error condition if
rsaModulusBitSize
< 32 or
rsaModulusBitSize
> 4096,
factorPBitSize
< 16 or
factorPBitSize
> 4096, or
factorQBitSize
< 16 or
factorQBitSize
> 4096.
ippStsBadArgErr
Indicates an error condition if
publicExpBitSize
>
rsaModulusBitSize
or
privateExpBitSize
>
rsaModulusBitSize
.
ippStsMemAllocErr
Indicates an error condition if the allocated memory is insufficient for the operation.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.