Clarify the priority in selecting TLS backends

In case a custom TLS plugin is provided, the order can be unclear
(next after OpenSSL is either Schannel on Windows, or Secure Transport
on Darwin, then a custom plugin, if any, and the last one is 'cert-only').

Pick-to: 6.6 6.5 6.2
Fixes: QTBUG-123092
Change-Id: I02bcc1fa5448f64846d561a72b2522af3286c66c
Reviewed-by: Mårten Nordheim <marten.nordheim@qt.io>
(cherry picked from commit 128645d02338029858dd3e03defeff9f16d80172)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Timur Pocheptsov 2024-03-20 15:45:32 +01:00 committed by Qt Cherry-pick Bot
parent ed96f3bd2f
commit 8e0bb88d96

View File

@ -1538,7 +1538,12 @@ QList<QString> QSslSocket::availableBackends()
from the list of available backends.
\note When selecting a default backend implicitly, QSslSocket prefers
the OpenSSL backend if available.
the OpenSSL backend if available. If it's not available, the Schannel backend
is implicitly selected on Windows, and Secure Transport on Darwin platforms.
Failing these, if a custom TLS backend is found, it is used.
If no other backend is found, the "certificate only" backend is selected.
For more information about TLS plugins, please see
\l {Enabling and Disabling SSL Support when Building Qt from Source}.
\sa setActiveBackend(), availableBackends()
*/