yuzu-emu/mbedtls
1
0
Fork 0
mirror of https://github.com/yuzu-emu/mbedtls.git synced 2024-11-26 23:35:43 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update the behavior of key handles

Browse Source 
* open output distinct key handles
* each handle must be closed
* destroying a key does not invalidate other handles
* closing a key can/might fail an active operation (but not required)
This commit is contained in:
Andrew Thoelke 2019-09-05 09:38:06 +01:00
parent 8096969905
commit de183416f8
1 changed files with 22 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
include/psa/crypto.h
View File

@ -361,15 +361,18 @@ void psa_reset_key_attributes(psa_key_attributes_t *attributes);
* keys that can be opened with psa_open_key(). Such keys have a key identifier * keys that can be opened with psa_open_key(). Such keys have a key identifier
* in the vendor range, as documented in the description of #psa_key_id_t. * in the vendor range, as documented in the description of #psa_key_id_t.
* *
* The application must eventually close the handle with psa_close_key() * The application must eventually close the handle with psa_close_key() or
* to release associated resources. If the application dies without calling * psa_destroy_key() to release associated resources. If the application dies
* psa_close_key(), the implementation should perform the equivalent of a * without calling one of these functions, the implementation should perform
* call to psa_close_key(). * the equivalent of a call to psa_close_key().
* *
* Some implementations permit an application to open the same key multiple * Some implementations permit an application to open the same key multiple
* times. Applications that rely on this behavior will not be portable to * times. If this is successful, each call to psa_open_key() will return a
* implementations that only permit a single key handle to be opened. See * different key handle.
* also :ref:\`key-handles\`. *
* \note Applications that rely on opening a key multiple times will not be
* portable to implementations that only permit a single key handle to be
* opened. See also :ref:\`key-handles\`.
* *
* \param id The persistent identifier of the key. * \param id The persistent identifier of the key.
* \param[out] handle On success, a handle to the key. * \param[out] handle On success, a handle to the key.
@ -411,8 +414,10 @@ psa_status_t psa_open_key(psa_key_id_t id,
* Closing the key handle makes the handle invalid, and the key handle * Closing the key handle makes the handle invalid, and the key handle
* must not be used again by the application. * must not be used again by the application.
* *
* If the key is currently in use in a multipart operation, then closing the * \note If the key handle was used to setup an active
* last remaining handle to the key will abort the multipart operation. * :ref:\`multipart operation <multipart-operations>\`, then closing the
* key handle can cause the multipart operation to fail. Applications should
* maintain the key handle until after the multipart operation has finished.
* *
* \param handle The key handle to close. * \param handle The key handle to close.
* *
@ -503,13 +508,16 @@ psa_status_t psa_import_key(const psa_key_attributes_t *attributes,
* memory and, if applicable, non-volatile storage. Implementations shall * memory and, if applicable, non-volatile storage. Implementations shall
* make a best effort to ensure that that the key material cannot be recovered. * make a best effort to ensure that that the key material cannot be recovered.
* *
* This function also erases any metadata such as policies and frees all * This function also erases any metadata such as policies and frees
* resources associated with the key. * resources associated with the key. To free all resources associated with
* the key, all handles to the key must be closed or destroyed.
* *
* Destroying a key will invalidate all existing handles to the key. * Destroying the key makes the handle invalid, and the key handle
* must not be used again by the application. Using other open handles to the
* destroyed key in a cryptographic operation will result in an error.
* *
* If the key is currently in use in a multipart operation, then destroying the * If a key is currently in use in a multipart operation, then destroying the
* key will abort the multipart operation. * key will cause the multipart operation to fail.
* *
* \param handle Handle to the key to erase. * \param handle Handle to the key to erase.
* *