Function esp_idf_svc::sys::mbedtls_ssl_conf_renegotiation_period

source ยท
pub unsafe extern "C" fn mbedtls_ssl_conf_renegotiation_period(
    conf: *mut mbedtls_ssl_config,
    period: *const u8,
)
Expand description

\brief Set record counter threshold for periodic renegotiation. (Default: 2^48 - 1)

            Renegotiation is automatically triggered when a record
            counter (outgoing or incoming) crosses the defined
            threshold. The default value is meant to prevent the
            connection from being closed when the counter is about to
            reached its maximal value (it is not allowed to wrap).

            Lower values can be used to enforce policies such as "keys
            must be refreshed every N packets with cipher X".

            The renegotiation period can be disabled by setting
            conf->disable_renegotiation to
            MBEDTLS_SSL_RENEGOTIATION_DISABLED.

\note When the configured transport is MBEDTLS_SSL_TRANSPORT_DATAGRAM the maximum renegotiation period is 2^48 - 1, and for MBEDTLS_SSL_TRANSPORT_STREAM, the maximum renegotiation period is 2^64 - 1.

\param conf SSL configuration \param period The threshold value: a big-endian 64-bit number.