ica_ed448_verify

Edit online

Purpose

Verifies the given ED448 signature using the public key from the context against the given message. Returns 0 if the signature is valid, returns -1 if the signature is invalid or an internal error occurred. If the context does not contain the public key, it is internally derived from the private key in the context.

Format


int ica_ed448_verify(ICA_ED448_CTX *ctx,
  unsigned char sig[114],
  const unsigned char *msg, 
  size_t msglen);

Required hardware support

The processor must have the MSA9 facility (STFLE bit 155) installed which is available starting with IBM z15® systems.

Parameters

ICA_ED448_CTX *ctx
Pointer to an ED448 context.
unsigned char sig[114]
Buffer containing the input signature.
const unsigned char *msg
Buffer containing the message as input.
size_t msglen
Length in bytes of the input message to be verified.

Return codes

0
Success. Signature is OK.
-1
If at least one invalid parameter is given, or MSA9 is not available. Also, if deriving the public from the private key fails and if the signature could not be correctly verified.

For return codes indicating exceptions, see Return codes.