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

Key derivation: allow both keys and direct inputs (function doc)

Browse source 
Update the documentation of psa_key_derivation_input_key() and
psa_key_derivation_input_bytes() now that the key/buffer distinction
is not mandatory.
This commit is contained in:
Gilles Peskine 2019-09-24 17:15:58 +02:00
parent b8965193a0
commit 7ebd4dcf57
1 changed files with 13 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
include/psa/crypto.h
View file

@ -3229,9 +3229,12 @@ psa_status_t psa_key_derivation_set_capacity(
* Refer to the documentation of each key derivation or key agreement * Refer to the documentation of each key derivation or key agreement
* algorithm for information. * algorithm for information.
* *
* This function passes direct inputs. Some inputs must be passed as keys * This function passes direct inputs, which is usually correct for
* using psa_key_derivation_input_key() instead of this function. Refer to * non-secret inputs. To pass a secret input, which should be in a key
* the documentation of individual step types for information. * object, call psa_key_derivation_input_key() instead of this function.
* Refer to the documentation of individual step types
* (`PSA_KEY_DERIVATION_INPUT_xxx` values of type ::psa_key_derivation_step_t)
* for more information.
* *
* If this function returns an error status, the operation enters an error * If this function returns an error status, the operation enters an error
* state and must be aborted by calling psa_key_derivation_abort(). * state and must be aborted by calling psa_key_derivation_abort().
@ -3274,10 +3277,13 @@ psa_status_t psa_key_derivation_input_bytes(
* Refer to the documentation of each key derivation or key agreement * Refer to the documentation of each key derivation or key agreement
* algorithm for information. * algorithm for information.
* *
* This function passes key inputs. Some inputs must be passed as keys * This function obtains input from a key object, which is usually correct for
* of the appropriate type using this function, while others must be * secret inputs or for non-secret personalization strings kept in the key
* passed as direct inputs using psa_key_derivation_input_bytes(). Refer to * store. To pass a non-secret parameter which is not in the key store,
* the documentation of individual step types for information. * call psa_key_derivation_input_bytes() instead of this function.
* Refer to the documentation of individual step types
* (`PSA_KEY_DERIVATION_INPUT_xxx` values of type ::psa_key_derivation_step_t)
* for more information.
* *
* If this function returns an error status, the operation enters an error * If this function returns an error status, the operation enters an error
* state and must be aborted by calling psa_key_derivation_abort(). * state and must be aborted by calling psa_key_derivation_abort().