yuzu/mbedtls
1
0
Fork 0
mirror of https://github.com/yuzu-emu/mbedtls.git synced 2025-01-22 23:21:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update documentation for psa_close_key

Browse source 
Adjust the wording to permit multiple handles to a single key - closing
a handle does not necessarily release volatile memory associated with
the key, that only occurs when the last handle is closed.
This commit is contained in:
Andrew Thoelke 2019-08-21 22:46:56 +01:00
parent 9741b11440
commit 3daba812d7
1 changed files with 11 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
include/psa/crypto.h
View file

@ -400,15 +400,19 @@ psa_status_t psa_open_key(psa_key_id_t id,
/** Close a key handle. /** Close a key handle.
* *
* If the handle designates a volatile key, destroy the key material and * If the handle designates a volatile key, this will destroy the key material
* free all associated resources, just like psa_destroy_key(). * and free all associated resources, just like psa_destroy_key().
* *
* If the handle designates a persistent key, free all resources associated * If this is the last open handle to a persistent key, then closing the handle
* with the key in volatile memory. The key in persistent storage is * will free all resources associated with the key in volatile memory. The key
* not affected and can be opened again later with psa_open_key(). * data in persistent storage is not affected and can be opened again later
* with a call to psa_open_key().
* *
* If the key is currently in use in a multipart operation, * Closing the key handle makes the handle invalid, and the key handle
* the multipart operation is aborted. * must not be used again by the application..
*
* If the key is currently in use in a multipart operation, then closing the
* last handle to the key will abort the multipart operation.
* *
* \param handle The key handle to close. * \param handle The key handle to close.
* *