file:        readme.txt
date:        April 10, 2007
description: Intelligent CRYPTO-BOX Setup "CBSetup.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 (Versa, XS, XL), 
CRYPTO-BOX Parallel (560/Net and Versa), CRYPTO-BOX Serial 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 CBSetup: 

- Windows(r) Vista (32/64bit, 64bit for CRYPTO-BOX USB only)
- Windows(r) XP and XP x64 (XP x64 for CRYPTO-BOX USB only)
- 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 
  Windows NT4.0/Me/98. 
  Other than that, start using MARX hardware right away!

  NOTE: CRYPTO-BOX USB (Versa, XS, XL) is currently supported for 
        Windows(r) 98/Me/2000/XP/Vista and NT 4.0 SP6.

+ "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:

CbSetup.exe /? - get a help screen

CbSetup.exe /Q /NET560 - run setup in quiet mode and install support of
                         CRYPTO-BOX Net/560

CbSetup.exe /Q /VERSA - run setup in quiet mode and install support of
                        CRYPTO-BOX Versa

CbSetup.exe /Q /SERIAL - run setup in quiet mode and install support of
                         CRYPTO-BOX Serial

CbSetup.exe /Q /CRYPTOKEN - run setup in quiet mode and install support of
                            CRYPTO-BOX USB (Versa, XS, XL)
 
CbSetup.exe /Q /U /NET560 - perform "quiet" uninstall of Net/560 drivers

CbSetup.exe /Q /NET560 /95 - force installation of old cbn.vxd V2.10 under
                             Windows Me/98

*************************************************************************
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
CBSETUP.EXE.

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

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:

            CbSetup.exe /Q /CRYPTOKEN
            CbSetup.exe /Q /NET560
            CbSetup.exe /Q /VERSA
            CbSetup.exe /Q /SERIAL

-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.


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

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

function UnInstDrivers()
	string szTargetFile
begin                   
        szTargetFile=WINSYSDIR^"\\CbSetup.exe";
    	LongPathToQuote(szTargetFile,TRUE);  
	LaunchAppAndWait (szTargetFile, "/Q /U /NET560", 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.