***************************************************************************
*                 Matrix Software Protection System                       *
*                     for Linux 32bit/64bit                               *
*                                                                         *
*                      Copyright (c) TDi GmbH                             *
***************************************************************************

===========
COMPONENTS:
===========
./API/$VERS/libmxlin.so.2.6.0        ... Matrix-API as shared library (32-bit)
./API/$VERS/libmxlin260.a            ... Matrix-API as static library (32-bit) 
./API/$VERS/libmxlin64.so.2.6.0      ... Matrix-API as shared library (64-bit) 
./API/$VERS/libmxlin64260.a          ... Matrix-API as static library (64-bit) 
./API/mxapi.h                        ... Matrix-API header file 
./API/mxtypes.h                      ... Definition of data types for 32 and 
                                         64 bit
./API/mxtea.h                        ... the TEA encryption algorithm
./API/install.sh                     ... a quick install script

$VERS:  x86                          ... for 32bit
        x86_64                       ... for 64bit
                
./API/readme_usb               ... how to install for usb
./API/matrix-rule-handler      ... udev  rulehandler script, see readme_usb 
./API/readme_redist            ... info about the redistributables



./samples/C/mxtest.c           ... a simple example program
./samples/C/Makefile           ... a Makefile to compile mxtest.c and
                                   to build a statically and dynamically 
				   linked executable; enter "make" to see
                                   the available targets

./samples/Java/Matrix.java     ... a Java class using JNI to access Matrix-API
./samples/Java/MxTea.java      ... an example implementation for tea
./samples/Java/Demo.java       ... a demo java application showing how to use
                                   the Matrix java class
./samples/Java/Makefile        ... a Makefile to compile the Java application;
                                   enter "make" to see the available targets
=============
INSTALLATION:
=============

-----------------
API Installation:
-----------------
IMPORTANT: Please use /usr/local/lib or /usr/lib for the destination, otherwise
           driver locking will not be working.

See API/install.sh for what is necessary to install libraries. 
install.sh installs the libraries in /usr/lib.

For fast installation on your system you can execute the install.sh script.
It asks you which libraries to install and copies them to /usr/lib.
WARNING: Old libraries will be deleted before installation!!!

Note: On customer systems, you do not need the static libraries (.a). 

-----------------
USB Installation:
-----------------
see API/readme_usb 

============
TESTPROGRAM:
============
It finds a connected dongle and prints some informations about it.

Before you can compile, install the libraries by executing API/install.sh.

Go to the 'samples/C' directory and enter 'make', to learn about the 
supported Makefile  targets.

=====================
Environmentvariables:
=====================
The following environment variables are honored by the Matrix-API library.

MXSPS_USB_ACQUIRE  specify a timeout to acquire the USB port, specify
                   a timeout in [s] (default is 5 seconds)
