Developer Reference

Contents

RSA_SetPublicKey, RSA_SetPrivateKeyType1, RSA_SetPrivateKeyType2

Set up an RSA key in the existing RSA key context.

Syntax

IppStatus ippsRSA_SetPublicKey(const IppsBigNumState*
pModulus
, const IppsBigNumState*
pPublicExp
, IppsRSAPublicKeyState*
pKey
);
IppStatus ippsRSA_SetPrivateKeyType1(const IppsBigNumState*
pModulus
, const IppsBigNumState*
pPrivateExp
, IppsRSAPrivateKeyState*
pKey
);
IppStatus ippsRSA_SetPrivateKeyType2(const IppsBigNumState*
pFactorP
, const IppsBigNumState*
pFactorQ
, const IppsBigNumState*
pCrtExpP
, const IppsBigNumState*
pCrtExpQ
, const IppsBigNumState*
pInverseQ
, IppsRSAPrivateKeyState*
pKey
);
Include Files
ippcp.h
Parameters
pModulus
The composite RSA modulus
n
.
pPublicExp
The
e
component of the RSA public key.
pPrivateExp
The
d
component of the type 1 RSA private key.
pFactorP
,
pFactorQ
The
p
and
q
factors of the RSA modulus
n
=
p
*
q
.
pCrtExpP
,
pCrtExpQ
The
dP
and
dQ
components of the quintuple (
p,q,dP,dQ,qInv
), which defines a type 2 private key.
pInverseQ
The
qInv
component of the quintuple (
p,q,dP,dQ,qInv
).
pKey
Pointer to the
IppsRSAPublicKeyState
or
IppsRSAPrivateKeyState
context.
Description
The
RSA_SetPublicKey
function sets up the RSA public key (
n
,
e
) in the
IppsRSAPublicKeyState
context, that is, copies the
n
and
e
components supplied by the user into the context.
The
RSA_SetPrivateKeyType1
function sets up the RSA type 1 private key (
n
,
d
) in the
IppsRSAPrivateKeyState
context, that is, copies the
n
and
d
components supplied by the user into the context.
The
RSA_SetPrivateKeyType2
function sets up the RSA type 2 private key (
p,q,dP,dQ,qInv
) in the
IppsRSAPrivateKeyState
context, that is, copies user-supplied
p
and
q
factors of the RSA composite modulus into the context, computes the rest of the key components, and copies them into the context:
  • dP
    =
    q
    mod (
    p
    -1)
  • dQ
    =
    p
    mod (
    q
    -1)
  • qInv
    = 1/
    q
    mod
    p
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
.
ippStsContextMatchErr
Indicates an error condition if any of the context parameters does not match the operation.
ippStsSizeErr
Indicates an error condition if the bit length of a key component specified by the
pModulus
,
pPublicExp
,
pPrivateExp
,
pFactorP
, or
pFactorQ
pointer exceeds the bit length specified at the initialization.
ippStsOutOfRangeErr
Indicates an error condition if any key component is not positive.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804