kcapi_kpp_dh_setparam_pkcs3(3)

kcapi_kpp_dh_setparam_pkcs33

Set the pg parameters using pkcs3 format

Usage

int kcapi_kpp_dh_setparam_pkcs3(struct kcapi_handle * handle, const uint8_t * pkcs3, uint32_t pkcs3len);

Arguments

handle

[in] cipher handle

pkcs3

[in] parameter buffer in DER format

pkcs3len

[in] length of key buffer

Overview

With this function, the caller sets the PG parameters for subsequent cipher operations.

The parameter set must be in DER format as follows

SEQUENCE { prime INTEGER ({ dh_get_p }), base INTEGER ({ dh_get_g }) }

The following command generates such parameter set where the output

File content is has the correct der structure

openssl dhparam -outform DER -out dhparam.der 2048

Note, this function defines that the subsequent key generation and shared secret operation performs an FFC Diffie-Hellman operation.

After the caller provided the key, the caller may destroy the parameter as it is now maintained by the kernel.

return upon success the value of the maximum size for the KPP operation is returned (e.g. the prime size); a negative errno-style error code if an error occurred

Releases

3 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12
  3. 13

Author

Stephan Mueller <[email protected]>

Author.

From libkcapi-dev 1.4.0-1+b2 in Debian 13 (Trixie). Parsed by carta from the page's man source.