
            Apache Tomcat Native Library


What is it?
-----------

The Apache Tomcat Native Library is an optional component for use with
Apache Tomcat that allows Tomcat to use OpenSSL as a replacement for JSSE
to support TLS connections.


Licensing
---------

Please see the file called LICENSE.

The Latest Version
------------------

Details of the latest version can be found on the Apache Tomcat
project page under https://tomcat.apache.org/.

Documentation
-------------

The documentation available as of the date of this release is
included in HTML format in the docs directory.
The most up-to-date documentation can be found at
https://tomcat.apache.org/native-doc/


Building
--------

To build the Java API. Note that Java 11 is required to build the Java API.
> ant

To build the native part see native/BUILDING.


Running the tests
-----------------

First run "ant download" to retrieve junit. It will be placed
in the directory given by "base.path". The path can be changed
by adjusting "base.path" in the file build.properties.default
or overwrite it in a new file build.properties.

Now run "ant test".


Cryptographic Software Notice
-----------------------------

This distribution may include software that has been designed for use
with cryptographic software.  The country in which you currently reside
may have restrictions on the import, possession, use, and/or re-export
to another country, of encryption software.  BEFORE using any encryption
software, please check your country's laws, regulations and policies
concerning the import, possession, or use, and re-export of encryption
software, to see if this is permitted.  See <http://www.wassenaar.org/>
for more information.

The U.S. Government Department of Commerce, Bureau of Industry and
Security (BIS), has classified this software as Export Commodity
Control Number (ECCN) 5D002.C.1, which includes information security
software using or performing cryptographic functions with asymmetric
algorithms.  The form and manner of this Apache Software Foundation
distribution makes it eligible for export under the License Exception
ENC Technology Software Unrestricted (TSU) exception (see the BIS
Export Administration Regulations, Section 740.13) for both object
code and source code.

Apache Tomcat Native uses cryptographic software for configuring and
listening to connections over SSL encrypted network sockets by
performing calls to a general-purpose encryption library, such as
OpenSSL or the operating system's platform-specific SSL facilities.
