The Apache Tomcat Native - Miscellaneous Documentation

This is the Changelog for Tomcat Native 1.2.

• 63671: libtcnative does not compile with OpenSSL < 1.1.0 and APR w/o threading support. (michaelo)
• Correct configure message for OpenSSL libdir. (michaelo)
• 64260: Clean up install target. (michaelo)
• 64315: configure output for OpenSSL wrong/incomplete sometimes. (michaelo)
• Drop obsolete build time workarounds for HP-UX. (michaelo)
• Add support for FreeBSD's pthread_getthreadid_np() in our ssl_thread_id(void). (michaelo)
• 63701: Use new OpenSSL initialisation process when building with OpenSSL 1.1.0 onwards. (mturk)
• Introduce tcn_get_thread_id(void) to reduce code duplication. (michaelo)
• Fix linking against OpenSSL in non-standard locations on FreeBSD. (michaelo)

• Make file fixes to enable building with APR 1.7.x. (markt)
• Switch to Windows 7 as the default target. (markt)
• Update minimum OpenSSL version to 1.0.2r. (markt)

• 63159: Unable to complete build when build directory is outside of the source tree. Patch provided by Bob Huemmer. (markt)
• 63356: Fix client certificate authentication when a certificate contains an AIA extension without an OCSP URI. Patch provided by Milind Takawale. (markt)
• 63500: Fix JVM crash on Connector start when a certificate revocation file or path is specified for OpenSSL. (markt)
• Add support for TLS key logging when using OpenSSL 1.1.1 or later. If the environment variable SSLKEYLOGFILE is set then the TLS keys will be logged to that file. Patch provided by John Kelly. (markt)
• Update build script after migration of soucre repository from Subversion to Git. (markt)

• Correct a possible JVM crash during shutdown caused by a bug in the fix for the per connection memory leak included in 1.2.20. (rjung)

• Update includedir name to tomcat-native instead of apr. (csutherl)
• Fix a minor memory leak. It occurred every time a TLS connector was started so the impact was very unlikely to be noticed. (markt)
• Fix some minor memory leaks that could occur after error conditions during TLS connector initialisation. (markt)
• Fix a per connection memory leak when using OpenSSL BIO. This is typically used when OpenSSL is providing the TLS support for NIO or NIO2. (markt)

• 62892: Fix memory leaks in OCSP handling. (jfclere)
• 62944: Fix copy/paste error that prevented TLS 1.0 and TLS 1.1 from being used if TLS 1.3 was available. Patch provided by Dean Rasheed. (markt)
• Include OpenSSL licensing information in the Tomcat Native binaries for Windows that are built with OpenSSL. (markt)
• Update recommended OpenSSL version to 1.0.2q or later. (markt)

• 62641: libtool invocations should use --tag=CC. (michaelo)
• Remove support for Netware as there has not been a supported Netware platform for a number of years. (markt)
• 62748: Add support for TLS 1.3 when built with OpenSSL 1.1.1 or equivalent. (schultz/markt)
• Expose the API necessary for CLIENT-CERT authentication to be correctly supported when using Tomcat's JSSE implementation backed by OpenSSL. (markt)

• 62094: Certificate verification using CRL with Tomcat APR connector does not work. (jfclere)
• 62122: undefined symbol: SSL_COMP_free_compression_methods. (jfclere)
• 62221: OCSP response processing uses always the first entry in the response. (jfclere)
• Further clean-up in the OCSP extension logic. (jfclere)

• Further clean-up in the parsing of the OCSP extension. (markt)

• Update recommended OpenSSL version to 1.0.2m. (markt)
• Correctly calculate field lengths when parsing the OCSP extension so that longer values are read correctly. (markt)
• Update the recommended APR version to 1.6.3 or later. (markt)

• Fix a small memory leak during certificate initialization. (rjung)
• Replace use of deprecated ASN1_STRING_data with ASN1_STRING_get0_data when building against OpenSSL 1.1.0 and newer. (rjung)
• Fix a thread local key leak. Only relevant when doing SSL.initialize() and Library.terminate() a lot of times. (rjung)

• Add missing source files to Visual Studio project files. (wrowe)
• Add support for the OpenSSL SSL_CONF API. (rjung)
• Add SSLContext.getCiphers(). (rjung)
• Add method to add a single CA certificate to the list of CA certificates which are accepted as issuers of client certificates. (rjung)
• Fix an error not announcing the correct CA list for client certificates during TLS handshake. (rjung)
• Fix renegotiation to obtain a client certificate from a user agent. (markt)
• 58434: Allow Tomcat Native to be compiled with LibreSSL. Note that some features may not be available when using LibreSSL. (markt)
• 60290: When building Tomcat Native, don't ignore the value of CC if explicitly set. Patch provided by Michael Osipov. (markt)
• 60301: When building Tomcat Native, allow the user to override the libtool specified by APR by setting the LIBTOOL environment variable. (markt)
• Update build to use APR 1.6.x, with 1.6.2 recommended. (markt)
• Update recommended OpenSSL version to 1.0.2l. (markt)

• Correct a regression in the fix for 59797 that triggered a JVM crash on shutdown in some Tomcat unit tests when using the APR/native connector. (markt)

• 52627: Prevent a crash in File.infoGet() caused by the use of uninitialised variables. Based on patch by Ilya Maykov. (markt)
• 55113: Document the process for creating a static tc-native library with a FIPS-enabled OpenSSL and update the nmake make file to support the process. (markt)
• 55114: Clean up building instructions for the native component and expand the instructions for building for Windows platforms. (markt)
• 55938: Resolve remaining clang-analyzer warnings. Note that the use of -1 to indicate the full array in File.(read|write)[Full] has been removed since it was only partially implemented and the implementation was faulty. (markt)
• 58082: Update unit tests to use JUnit 4. Refactor unit tests into separate tests and use an external to reference them in the same way an external is used to reference the main code. (markt)
• 59797: Ensure that the per thread error hash maintained by OpenSSL is cleaned up as individual threads exit to ensure it does not grow too large. Patch provided by Nate Clark. (markt)
• 59996: Correctly handle building tc-native on a 64-bit system when using an OpenSSL distribution that is not in /usr. (csutherl)
• 60388: The --disable-maintainer-mode option of the configure script no longer enables the maintainer mode. (ebourg)
• Update minimum recommended OpenSSL version to 1.0.2k. (markt)

• Update minimum recommended OpenSSL version to 1.0.2j. (markt)

• Update minimum recommended OpenSSL version to 1.0.2i. (markt)

• 59616: Correct the Windows build files so that OCSP is correctly enabled and disabled in the respective Windows binaries. (markt)
• Correctly handle OS level EAGAIN return codes during non-blocking TLS I/O. (markt)
• Correct a potential performance problem identified by Nate Clark due to Tomcat Native providing OpenSSL with thread identifiers poorly suited to the hash function used by OpenSSL when selecting a bucket for the hash that holds the per thread error data. Tomcat Native on Windows and on Solaris were not affected. A fix has been applied for OSX and Linux. Other platforms may still be affected. (markt/rjung)

• Update minimum recommended OpenSSL version to 1.0.2h. (markt)

• Change the OpenSSL version check in configure to be fatal. (rjung)
• Use new OpenSSL 1.1.0 protocol version max and min API when creating a new SSL context. (rjung)
• Improve renegotiation code and make it compatible with OpenSSL 1.1.0. (rjung)
• OpenSSL 1.1.0 compatibility updates. (rjung)
• Fix some compiler warnings in native ssl code. (rjung)
• Add support for using Java keystores for certificate chains. (markt)
• Remove the explicit CRL check when verifying certificates. The checks were already part of the internal certification verification since OpenSSL 0.9.7. Backport from mod_ssl. (rjung)

• Enable OpenSSL version check in configure by default. It can be turned off using --disable-openssl-version-check. (rjung)
• 59024: Native function versionString() and for OpenSSL 1.1.0 also version() (both in in ssl.c) now return the OpenSSL run time version, not the compile time version. (rjung)
• Track changes in the OpenSSL master branch so it is possible to build Tomcat Native with that branch. (billbarker)

• SSL.getHandshakeCount(), which was unused, now returns the handshake completed count rather than the handshake started count. (remm)

• Remove Java classes that do not have C implementation code for their native methods in the current library. They were used for NPN support which is superseded by ALPN support in the current code. (kkolinko)
• Fix typo in declaration of a stub method used when the library is compiled without OpenSSL support. (kkolinko)
• Fix the signature of the implementation of the native SSL method newSSL() in the case when OPENSSL is not available. (rjung)
• Fix the signature of the implementation of the native SSLSocket method getInfoB() to return jbyteArray instead of jobject. This is consistent with what it actually returns and how the native Java method is declared. (rjung)
• Add support for using Java keystores for certificates and keys. (jfclere)
• Remove code that performs a read after a renegotiation that appears to be unnecessary with OpenSSL 1.0.2. (billbarker)
• Expose SSL_renegotiate to the Java API. (remm)

• Fix broken debug and maintainer mode build. (rjung)
• Forward port additional fixes to the OpenSSL I/O to align it with non-OpenSSL I/O. (markt)

• 58566: Enable Tomcat Native 1.2.x to work with Tomcat releases that do not have the necessary Java code to support SNI. (markt)
• Minor rework of "buildconf" script. (rjung)
• Fix APR dependency version expression in RPM spec file. (rjung)
• Fix major library version number in Windows build files, RPM spec file and build description. (rjung)
• Remove files "KEYS" and "download_deps.sh" from Windows (zip) source distribution. (rjung)
• Fix "unused variable" compiler warning. (rjung)

• Add support for TLS extension ALPN. (markt)
• Add support for TLS extension SNI (Server Name Indication). (markt)
• Add support for OpenSSL BIO. (jfclere)
• Support wakeable pollsets and add Poll.interrupt() API. (mturk)
• Add Pool.unmanaged() API. (mturk)
• APIs SSL.generateRSATempKey() and SSL.loadDSATempKey() have been removed. (rjung)
• The minimum required APR version is 1.4.3.
• The minimum required OpenSSL version is 1.0.2.

Please see the 1.1.x changelog.