@@ -1910,14 +1910,26 @@ impl SslContextBuilder {
19101910 unsafe { ffi:: SSL_CTX_set_aes_hw_override ( self . as_ptr ( ) , enable as _ ) }
19111911 }
19121912
1913- /// Sets whether the preserve TLS 1.3 cipher list option should be enabled.
1913+ /// Sets whether to preserve the TLS 1.3 cipher list as configured by [`Self::set_cipher_list`].
1914+ ///
1915+ /// By default, BoringSSL does not preserve the TLS 1.3 cipher list. When this option is disabled
1916+ /// (the default), BoringSSL uses its internal default TLS 1.3 cipher suites in its default order,
1917+ /// regardless of what is set via [`Self::set_cipher_list`].
1918+ ///
1919+ /// When enabled, this option ensures that the TLS 1.3 cipher suites explicitly set via
1920+ /// [`Self::set_cipher_list`] are retained in their original order, without being reordered or
1921+ /// modified by BoringSSL's internal logic. This is useful for maintaining specific cipher suite
1922+ /// priorities for TLS 1.3. Note that if [`Self::set_cipher_list`] does not include any TLS 1.3
1923+ /// cipher suites, BoringSSL will still fall back to its default TLS 1.3 cipher suites and order.
19141924 ///
19151925 /// This feature isn't available in the certified version of BoringSSL.
19161926 ///
19171927 /// # Note
19181928 ///
1919- /// This method must be called before [`Self::set_cipher_list`] to take effect.
1929+ /// This method must be called ** before** [`Self::set_cipher_list`] to take effect.
19201930 /// If called after [`Self::set_cipher_list`], the setting will be ignored.
1931+ ///
1932+ /// [`Self::set_cipher_list`]: #method.set_cipher_list
19211933 #[ cfg( not( feature = "fips" ) ) ]
19221934 #[ corresponds( SSL_CTX_set_preserve_tls13_cipher_list ) ]
19231935 pub fn set_preserve_tls13_cipher_list ( & mut self , enable : bool ) {
0 commit comments