file:        readme.txt
date:        April 10, 2006
description: Intelligent CRYPTO-BOX USB Setup "CBUSetup.exe"


CONTENTS
--------
- Overview
- Operating System Supported
- Key Features
- Exit Codes
- Automatic Uninstallation

*************************************************************************
Overview
*************************************************************************
This setup performs automatic installation of CRYPTO-BOX related components 
depending of the operating system. The installer is a self-extracting tool 
which contains all files needed to support CRYPTO-BOX USB and is thus 
self-sufficient.

After the setup completes installation there is *no need* to reboot 
because the drivers are loaded and started right away! NOTE: If you are 
installing support for CRYPTO-BOX USB under NT 4.0 you *do* need
to reboot, though.

*************************************************************************
Operating System Supported
*************************************************************************
The following operating systems are supported by CBUSetup: 

- Windows(r) Vista (32/64bit)
- Windows(r) XP and XP x64
- Windows(r) 2000
- Windows(r) NT 4.0 SP6
- Windows(r) Me (Millennium, August 2000 release)
- Windows(r) 98

*************************************************************************
Key Features
*************************************************************************

+ Detection of the operating system, installation and registration of 
appropriate device drivers.

  NOTE: You do not need to restart your PC after device drivers are 
  set up unless you are installing support for CRYPTO-BOX USB under NT 4.0. 
  Other than that, start using MARX hardware right away!


+ "Quiet" mode of installation. This feature makes it possible to integrate the 
setup into other proprietary installations.

In both the "quiet" and the normal modes the setup returns exit codes which 
help external setup analyze how the installation went. Please, refer to the 
section titled "Exit Codes" below.


*************************************************************************
Syntax
*************************************************************************
Please, use the following syntax when running the setup:

CBUSetup.exe /? - get a help screen

CBUSetup.exe /Q /CRYPTOKEN - run setup in quiet mode and install support of
                             CRYPTO-BOX USB 

CBUSetup.exe /Q /U /CRYPTOKEN - perform "quiet" uninstall of CRYPTO-BOX USB

CBUSetup.exe /Q /CRYPTOKEN /DRIVERONLY  - install the driver without any 
additional files (the SMRXCOM ActiveX COM object will not be installed)
 
*************************************************************************
Exit Codes
*************************************************************************
As was mentioned, you can run the setup in a "quiet" and a normal mode. 
The "quiet" mode makes it convenient to redistribute the setup and include it 
into proprietary installations. By analyzing the return value of the setup, the 
proprietary installation can find out how about the successful execution of
CTSETUP.EXE.

Following is a list of exit codes you may get from CBUSETUP:

0          No errors occurred.

-1         The installer could not detect your operating system.

-2         The user aborted installation.

-3         Wrong verision of the operating system.

-4         The setup had an internal error. Please, contact your distributor to 
           notify about this problem.

-5         The user has requested the installer  to run in the "quiet" mode but 
           the device was set incorrectly. Run the installer with a help switch 
           (/? or /H) to see the command line syntax. The following command line 
           syntax is acceptable:

            CTSetup.exe /Q /CRYPTOKEN

-6         The user does not have enough rights if the installer is run in
           Windows NT/2000/XP. Contact your System Administrator.

-7         The installer could not perform registration of device driver(s).
           Please, run the installer again, and if the problem persists,
           contact your disctributor.


CrypToken installation sample for IShield script (without exit code check):

function InstDrivers()
	string szPath,szTargetFile; 
begin  
    	szPath=TARGETDIR^"\\Drivers\\CTSetup\\CBUSetup.exe";
    	szTargetFile=WINSYSDIR^"\\CBUSetup.exe";
        CopyFile (szPath, szTargetFile); 
    	LongPathToQuote(szTargetFile,TRUE);
	LaunchAppAndWait (szTargetFile, "/Q /CRYPTOKEN", WAIT);
end;

function UnInstDrivers()
	string szTargetFile
begin                   
        szTargetFile=WINSYSDIR^"\\CBUSetup.exe";
    	LongPathToQuote(szTargetFile,TRUE);  
	LaunchAppAndWait (szTargetFile, "/Q /U /CRYPTOKEN", WAIT);
	DeleteFile(szTargetFile);
end;


**** Copyright (c) 2002, 2007 by MARX(R) Cryptotech LP ****


Windows is a registered trademark of Microsoft Corporation in the United 
States and/or other countries.