Reference to RFC 9146 added

Added deprecated keyword to MBEDTLS_SSL_DTLS_CONNECTION_ID_COMPAT

Signed-off-by: Hannes Tschofenig <hannes.tschofenig@arm.com>
Signed-off-by: Manuel Pégourié-Gonnard <manuel.pegourie-gonnard@arm.com>
This commit is contained in:
Hannes Tschofenig 2022-11-23 10:44:11 +01:00 committed by Manuel Pégourié-Gonnard
parent 88e5566a9b
commit e2c46e0413

View file

@ -1320,9 +1320,10 @@
/** /**
* \def MBEDTLS_SSL_DTLS_CONNECTION_ID * \def MBEDTLS_SSL_DTLS_CONNECTION_ID
* *
* Enable support for the DTLS Connection ID extension, * Enable support for the DTLS Connection ID (CID) extension,
* which allows to identify DTLS connections across changes * which allows to identify DTLS connections across changes
* in the underlying transport. * in the underlying transport. The CID functionality is described
* in RFC 9146.
* *
* Setting this option enables the SSL APIs `mbedtls_ssl_set_cid()`, * Setting this option enables the SSL APIs `mbedtls_ssl_set_cid()`,
* mbedtls_ssl_get_own_cid()`, `mbedtls_ssl_get_peer_cid()` and * mbedtls_ssl_get_own_cid()`, `mbedtls_ssl_get_peer_cid()` and
@ -1352,6 +1353,13 @@
* Set the value to 0 for the standard version, and * Set the value to 0 for the standard version, and
* 1 for the legacy draft version. * 1 for the legacy draft version.
* *
* \deprecated Support for the legacy version of the DTLS
* Connection ID feature is deprecated. Please
* switch to the standardized version defined
* in RFC 9146 enabled by utilizing
* MBEDTLS_SSL_DTLS_CONNECTION_ID without use
* of MBEDTLS_SSL_DTLS_CONNECTION_ID_COMPAT.
*
* Requires: MBEDTLS_SSL_DTLS_CONNECTION_ID * Requires: MBEDTLS_SSL_DTLS_CONNECTION_ID
*/ */
#define MBEDTLS_SSL_DTLS_CONNECTION_ID_COMPAT 0 #define MBEDTLS_SSL_DTLS_CONNECTION_ID_COMPAT 0