/*****************************************************************************
Copyright:   : Copyright (c) 2003, 2019 by MARX(R) CryptoTech LP
File         : readme.txt
Date         : 27FEB2019
Tools        : JDK 1.6 and higher
Description  : Java JCBIOS solution
               Java application sample
OS           : Win10/Win8/Win7/Vista/XP/2000
******************************************************************************

History:
	27FEB2019      jnicbios bug fixes (fix CBU2_GetKeyInfoAES function
 
                      and RSA key generation function, 
		       which didn't update out parameters)

        20FEB2019      jnicbios.dll bug fixes (CBIOS extented API functions),
                       add CBU2 AES encryption sample
        19MAR2015      TEOS_DO support added; rebuild with latest libraries
        23MAR2011      CBIOS library fixes
        13NOV2009      CBU2 support added, x86&x64 jnicbios detection added
        11SEP2008      Network CBIOS library speed improvements
        11SEP2008      Network CBIOS library speed improvements
        27DEC2007      network server UDP broadcasting functionality added to 
                       native Dll and sample
        27SEP2007      jnicbios.dll bug fixes (handle leaks and initialization 
                       under Vista for terminal sessions)
        21MAR2007      network functionality added to native Dll and sample
        22DEC2006      support for Vista32 added
        10FEB2006      rebuild with new CBIOS functions
        30MAY2005      native library rebuilt with revised CBIOS
        19JAN2005      firmware 2.0 supported
        16NOV2004      native library rebuilt with fixed CBIOS (64K caching)
        06OCT2004      sample output improved, hardware models info added
        27MAY2004      test algorythm revision
        03FEB2004      CBIOS improvements, native JNI library rebuild
        12NOV2003      Initial version

1. How it works: CBIOS Java solution architecture
-----------------------------------------------

Current MARX(R) solution for Java assumes that Java applet/application 
communicates with MARX(R) devices via JCBIOS.

Solution is based on the following components: 

1) x86\jnicbios.dll,
   x64\jnicbios.dll modules - Win32/Win64 modules with implemented CBIOS1.6
 functionality for  being accessed by java wrapper via JNI (Java Native Interface).
2) com.marx.jcbios package - collection of java classes, implementing interface
   to access native methods of CBIOS1.6.

Using JNI as means of access allows developing Java applet/application using 
only pure Java.

NOTE: It's highly recommended to invoke jcbios methods via SSL for 
security reasons!!!


2. How to start 
---------------------------------------------------

To start a sample you need to:

1) Install Java 6 SDK v 1.6.0 or higher.
   Or install JRE (Java Runtime Environment) v 1.6.x (or higher)
   The latest versions can be downloaded from 
   http://java.sun.com/
        
2) Copy jcbios package and collection of sample classes to the working 
   directory.
   Make sure you set CLASSPATH environment variable to the right value. 
   For instance: 
   CLASSPATH=.;C:\JAVA\LIB;C:\JavaProject.

3) Run java <SampleName> if JSDK is used.
   Run jre  <SampleName> if JRE is used.

   NOTE: Sample's name should not contain extension. Class names are 
case sensitive.


3. Java application sample
--------------------------

CBIOSTest sample designed to show CBIOS functionality for  CRYPTO-BOX(R) USB.      


*********** (c) Copyright 2003-2019 by MARX(R) CryptoTech LP  **************
*****************************************************************************/