AuroraMiddleware/mbedtls
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

SSL async callbacks documentation: clarify resource cleanup

Browse Source 
Clarify when resume must clean up resources and when cancel is called.
This commit is contained in:
Gilles Peskine 2018-04-30 13:57:45 +02:00
parent 26d01bcb5c
commit ea5fab829c
1 changed files with 12 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
include/mbedtls/ssl.h
View File

@ -576,7 +576,7 @@ typedef struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item;
* *
* This function may call mbedtls_ssl_set_async_operation_data() * This function may call mbedtls_ssl_set_async_operation_data()
* to store an operation context for later retrieval * to store an operation context for later retrieval
* by the resume callback. * by the resume or cancel callback.
* *
* \note For RSA signatures, this function must produce output * \note For RSA signatures, this function must produce output
* that is consistent with PKCS#1 v1.5 in the same way as * that is consistent with PKCS#1 v1.5 in the same way as
@ -653,7 +653,7 @@ typedef int mbedtls_ssl_async_sign_t( mbedtls_ssl_context *ssl,
* *
* This function may call mbedtls_ssl_set_async_operation_data() * This function may call mbedtls_ssl_set_async_operation_data()
* to store an operation context for later retrieval * to store an operation context for later retrieval
* by the resume callback. * by the resume or cancel callback.
* *
* \warning RSA decryption as used in TLS is subject to a potential * \warning RSA decryption as used in TLS is subject to a potential
* timing side channel attack first discovered by Bleichenbacher * timing side channel attack first discovered by Bleichenbacher
@ -716,6 +716,10 @@ typedef int mbedtls_ssl_async_decrypt_t( mbedtls_ssl_context *ssl,
* It may call mbedtls_ssl_set_async_operation_data() to modify * It may call mbedtls_ssl_set_async_operation_data() to modify
* this context. * this context.
* *
* Note that when this function returns a status other than
* #MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS, it must free any
* resources associated with the operation.
*
* \param ssl The SSL connection instance. It should not be * \param ssl The SSL connection instance. It should not be
* modified other than via * modified other than via
* mbedtls_ssl_set_async_operation_data(). * mbedtls_ssl_set_async_operation_data().
@ -745,7 +749,12 @@ typedef int mbedtls_ssl_async_resume_t( mbedtls_ssl_context *ssl,
* \brief Callback type: cancel external operation. * \brief Callback type: cancel external operation.
* *
* This callback is called if an SSL connection is closed * This callback is called if an SSL connection is closed
* while an asynchronous operation is in progress. * while an asynchronous operation is in progress. Note that
* this callback is not called if the
* ::mbedtls_ssl_async_resume_t callback has run and has
* returned a value other than
* #MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS, since in that case
* the asynchronous operation has already completed.
* *
* This function may call mbedtls_ssl_get_async_operation_data() * This function may call mbedtls_ssl_get_async_operation_data()
* to retrieve an operation context set by the start callback. * to retrieve an operation context set by the start callback.