ica_ed448_ctx_new

Edit online

Purpose

Allocates a new ED448 context and returns its address as output parameter. The context buffer is used by all other ica_ed448_... functions as a working area and must not be changed by the application. It must be freed by the corresponding ica_ed448_ctx_del function when no longer needed.

Format

int ica_ed448_ctx_new(ICA_ED448_CTX **ctx);

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
Address of a pointer to an ED448 context.

Return codes

0
Success
-1
If at least one invalid parameter is given or MSA9 is not available.

For return codes indicating exceptions, see Return codes.