@@ -1304,8 +1304,8 @@ Host name validation can be customized with
13041304.. note ::
13051305 The improved host name check requires a *libssl * implementation compatible
13061306 with OpenSSL 1.0.2 or 1.1. Consequently, OpenSSL 0.9.8 and 1.0.1 are no
1307- longer supported. The ssl module is mostly compatible with LibreSSL 2.7.2
1308- and newer.
1307+ longer supported (see :ref: ` 37-platform-support-removals ` for more details).
1308+ The ssl module is mostly compatible with LibreSSL 2.7.2 and newer.
13091309
13101310The ``ssl `` module no longer sends IP addresses in SNI TLS extension.
13111311(Contributed by Christian Heimes in :issue: `32185 `.)
@@ -2069,10 +2069,33 @@ or higher. (Contributed by Serhiy Storchaka in :issue:`27867`.)
20692069(Contributed by Antoine Pitrou in :issue: `16500 `.)
20702070
20712071
2072+ .. _37-platform-support-removals :
2073+
20722074Platform Support Removals
20732075=========================
20742076
2075- FreeBSD 9 and older are no longer officially supported.
2077+ * FreeBSD 9 and older are no longer officially supported.
2078+ * For full Unicode support, including within extension modules, \* nix platforms
2079+ are now expected to provide at least one of ``C.UTF-8 `` (full locale),
2080+ ``C.utf8 `` (full locale) or ``UTF-8 `` (``LC_CTYPE ``-only locale) as an
2081+ alternative to the legacy ``ASCII ``-based ``C `` locale.
2082+ * OpenSSL 0.9.8 and 1.0.1 are no longer supported, which means building CPython
2083+ 3.7 with SSL/TLS support on older platforms still using these versions
2084+ requires custom build options that link to a more recent version of OpenSSL.
2085+
2086+ Notably, this issue affects the Debian 8 (aka "jessie") and Ubuntu 14.04
2087+ (aka "Trusty") LTS Linux distributions, as they still use OpenSSL 1.0.1 by
2088+ default.
2089+
2090+ Debian 9 ("stretch") and Ubuntu 16.04 ("xenial"), as well as recent releases
2091+ of other LTS Linux releases (e.g. RHEL/CentOS 7.5, SLES 12-SP3), use OpenSSL
2092+ 1.0.2 or later, and remain supported in the default build configuration.
2093+
2094+ CPython's own :source: `CI configuration file <.travis.yml> ` provides an
2095+ example of using the SSL
2096+ :source: `compatibility testing infrastructure <Tools/ssl/multissltests.py> ` in
2097+ CPython's test suite to build and link against OpenSSL 1.1.0 rather than an
2098+ outdated system provided OpenSSL.
20762099
20772100
20782101API and Feature Removals
0 commit comments