ica_x448_ctx_new

Edit online

Purpose

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

Format

int ica_x448_ctx_new(ICA_X448_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_X448_CTX **ctx
Address of a pointer to an X448 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.