yuzu-emu/mbedtls
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Improve documentation the shared secret format for FFDH

Browse source
This commit is contained in:
Gilles Peskine 2018-11-15 17:47:25 +01:00
parent d171e78b46
commit 99d0259987
1 changed files with 5 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
include/psa/crypto.h
View file

@ -1228,8 +1228,11 @@ typedef uint32_t psa_algorithm_t;
* public key, with a key selection or key derivation algorithm to produce * public key, with a key selection or key derivation algorithm to produce
* one or more shared keys and other shared cryptographic material. * one or more shared keys and other shared cryptographic material.
* *
* The input to \p kdf_alg is the shared secret `g^{ab}` in big-endian format. * The shared secret produced by key agreement and passed as input to the
* It is `ceiling(n / 8)` bytes long where `n` is the size of the prime `p`. * derivation or selection algorithm \p kdf_alg is the shared secret
* `g^{ab}` in big-endian format.
* It is `ceiling(m / 8)` bytes long where `m` is the size of the prime `p`
* in bits.
* *
* \param kdf_alg A key derivation algorithm (\c PSA_ALG_XXX value such * \param kdf_alg A key derivation algorithm (\c PSA_ALG_XXX value such
* that #PSA_ALG_IS_KEY_DERIVATION(\p hash_alg) is true) * that #PSA_ALG_IS_KEY_DERIVATION(\p hash_alg) is true)