The Apache Tomcat Native - Miscellaneous Documentation -
Author: Jean-Frederic Clere

##

### Preface

This is the Changelog for Tomcat Native 1.2.

### Changes in 1.2.14

- 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)

### Changes in 1.2.13

- 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)

### Changes in 1.2.12

- 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)

### Changes in 1.2.11

- 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)

### Changes in 1.2.10

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

### Changes in 1.2.9

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

### Changes in 1.2.8

- 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)

### Changes in 1.2.7

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

### Changes in 1.2.6

- 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)

### Changes in 1.2.5

- 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)

### Changes in 1.2.4

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

### Changes in 1.2.3

- 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)

### Changes in 1.2.2

- 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)

### Changes in 1.2.1

- 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)

### Changes in 1.2.0

- 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.

### Changes in 1.1.x

Please see the 1.1.x changelog.