ica_ec_key_generate

Purpose

Generates private and public ECC key values for a given ICA_EC_KEY data structure.

Note: In FIPS mode (140-2 and later), ECC key generation is performed by OpenSSL, because this ensures that the generated keys satisfy the FIPS requirements.

Format


int ica_ec_key_generate(ica_adapter_handle_t adapter_handle, 
    ICA_EC_KEY *key);

Required hardware support

At least, a Crypto Express4S CCA coprocessor is required (CEX4C or later).

Parameters

ica_adapter_handle_t adapter_handle
Pointer to a previously opened device handle.
ICA_EC_KEY *key
Pointer to a previously allocated ICA_EC_KEY data structure.

Return codes

0
Success
EINVAL
If at least one invalid parameter is given.
ENOMEM
If memory could not be allocated.
EFAULT
If an internal processing error occurred.
EPERM
If the EC curve is not supported in this environment.

For return codes indicating exceptions, see Return codes.