=====================================================================
===============   Matrix software protection system   ===============
===============                for                    ===============
===============           JAVA applications           ===============
=====================================================================
===============        Copyright (c) TDi GmbH         ===============
=====================================================================

IMPLEMENTATION OF THE MATRIX-DONGLE IN JAVA APPLICATIONS
--------------------------------------------------------
The Matrix-API also includes the Java interface JNI (Java Native 
Interface). The Matrix-API will need to be in the Java-Path or in 
the Path of your application, so that your application can find it.
This version supports Windows (JNI), Linux (JNI) and Mac-OSX (JNI).


Requirements on Windows:
------------------------
Matrix-API for Windows (matrix32.dll). The minimal version which 
includes the JNI interface is v2.60.


Requirements on Linux:
----------------------
Matrix-API for Linux (libmxlin.so.x.x.x). The minimal version which 
includes the JNI interface is 2.6.0 (libmxlin.so.2.6.0).
In addition you need to provide the following symbolic link:

ln -s  ${LIBDIR}/libmxlin.so.2.6.0  ${LIBDIR}/libmatrix32.so


Requirements on Mac-OSX:
------------------------
Matrix-API for Mac-OSX (libmxmacxxx.dylib). The minimal version 
which includes the JNI interface is 260 (libmxmac260.dylib).
In addition you need to provide a symbolic link in /usr/lib as 
follows:

cd /usr/lib
ln -s  libmxmac260.dylib libmatrix32.jnilib


File description:
-----------------
'Matrix.class' - is the interface class to access the Matrix-API.
'Matrix.java'  - is the source code of the Java class with the
                 interface to access the Matrix-API.
'MxTea.class'  - is the Java class with the implementation of the 
                 TEA encryption algorithm.
'MxTea.java'   - is the source code of the Java class with the
                 implementation of the TEA encryption algorithm.
'Demo.java'    - is a sample program to demonstrate the integration
                 of the Matrix dongle.

Start the demo program by executing 'java Demo'.

