ARMmbed/mbedtls
1
0
Fork 0
mirror of https://github.com/ARMmbed/mbedtls.git synced 2025-05-22 16:39:56 +08:00
Code Issues Releases Wiki Activity

Update key attribute documentation inline with PSA

Browse Source 
Signed-off-by: Paul Elliott <paul.elliott@arm.com>
This commit is contained in:
Paul Elliott 2024-08-01 17:52:51 +01:00
parent 459448b8cf
commit 5238475ac6
1 changed files with 22 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
tf-psa-crypto/include/psa/crypto.h
View File

@ -4933,27 +4933,28 @@ uint32_t psa_key_agreement_iop_get_num_ops(psa_key_agreement_iop_t *operation);
* #PSA_ALG_IS_KEY_AGREEMENT(\p alg) is true). * #PSA_ALG_IS_KEY_AGREEMENT(\p alg) is true).
* *
* \param[in] attributes The attributes for the new key. * \param[in] attributes The attributes for the new key.
* This function uses the attributes as follows: * The following attributes are required for all
* * The key type must be one of * keys:
* `PSA_KEY_TYPE_DERIVE`,`PSA_KEY_TYPE_RAW_DATA`, * * The key type, which must be one of
* `PSA_KEY_TYPE_HMAC`, or * #PSA_KEY_TYPE_DERIVE, #PSA_KEY_TYPE_RAW_DATA,
* `PSA_KEY_TYPE_PASSWORD`. * #PSA_KEY_TYPE_HMAC or #PSA_KEY_TYPE_PASSWORD.
* * The size of the returned key is always the * The following attributes must be set for keys
* bit-size of the shared secret, rounded up to a * used in cryptographic operations:
* whole number of bytes. The key size in \p * * The key permitted-algorithm policy
* attributes can be zero; if it is nonzero, * * The key usage flags
* it must be equal to the output size of the key * The following attributes must be set for keys
* agreement, in bits. * that do not use the default volatile lifetime:
* * The output size, in bits, of the key agreement * * The key lifetime
* is #PSA_RAW_KEY_AGREEMENT_OUTPUT_SIZE(\c type, * * The key identifier is required for a key with
* \c bits), where \c type and \c bits are the * a persistent lifetime
* type and bit-size of \p private_key. * The following attributes are optional:
* * The key permitted-algorithm policy is required * * If the key size is nonzero, it must be equal
* for keys that will be used for a cryptographic * to the output size of the key agreement,
* operation. The key usage flags define what * in bits.
* operations are permitted with the key. The key * The output size, in bits, of the key agreement
* lifetime and identifier are required for a * is 8 * #PSA_RAW_KEY_AGREEMENT_OUTPUT_SIZE(\c
* persistent key. * type, \c bits), where \c type and \c bits are
* the type and bit-size of \p private_key.
* *
* \note \p attributes is an input parameter, it is not * \note \p attributes is an input parameter, it is not
* updated with the final key attributes. The final * updated with the final key attributes. The final