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.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>
(cherry picked from commit 8e0bb88d96374de4992944f05dc5ff8e5e82af6f)
This commit is contained in:
Timur Pocheptsov 2024-03-20 15:45:32 +01:00 committed by Qt Cherry-pick Bot
parent b52f20c97b
commit 2bace7a888

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()
*/