Developer Reference

Contents

RSAVerify_PKCS1v15

Carries out the RSA-SSA signature verification scheme of PKCS#1 v1.5.

Syntax

IppStatus ippsRSAVerify_PKCS1v15
(
const Ipp8u*
pMsg
, int
msgLen
, const Ipp8u*
pSign
, int*
pIsSignValid
, const IppsRSAPublicKeyState*
pKey
, IppHashAlgId
hashAlg
, Ipp8u*
pBuffer
);
IppStatus ippsRSAVerify_PKCS1v15_rmf
(
const Ipp8u*
pMsg
, int
msgLen
, const Ipp8u*
pSign
, int*
pIsSignValid
, const IppsRSAPublicKeyState*
pKey
, const IppsHashMethod*
pMethod
, Ipp8u*
pBuffer
);
Include Files
ippcp.h
Parameters
pMsg
Pointer to the message that has been signed.
msgLen
Length of the message
*pMsg
in octets.
pSign
Pointer to the signature string to be verified.
pIsSignValid
Pointer to the verification result.
pKey
Pointer to the properly initialized
IppsRSAPublicKeyState
context.
hashAlg
Identifier of the hash algorithm. For details, see table Supported Hash Algorithms.
pMethod
Pointer to the hash method. For details, see HashMethod functions.
pBuffer
Pointer to a temporary buffer of size not less than returned by the
RSA_GetBufferSizePublicKey
function.
Description
The function verifies the signature generated by the RSASign_PKCS1v15 function that uses the same
hashAlg
or
pMethod
parameter against the input message, as defined [PKCS 1.2.1].
This function has a
reduced memory footprint
version. To learn more, see Reduced Memory Footprint 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
.
ippStsContextMatchErr
Indicates an error condition if the context parameter does not match the operation.
ippStsIncompleteContextErr
Indicates an error condition if the public key is not set up.
You can set up the public key in a call to
RSA_SetPublicKey
.
ippStsLengthErr
Indicates an error condition if any input/output length parameters are inconsistent with one another.
ippsStsNotSupportedModeErr
Indicates an error condition if the
hashAlg
parameter does not match any value of
IppHashAlgId
listed in table Supported Hash Algorithms.

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