DAI Comparescan User's Guide
Getting Started


Next Prev Top Contents Index Home Page Send Feedback

Getting Started
Starting DAI Comparescan
Rules and SST files on the command line
DAI Comparescan Exit Codes
Examining previously saved DAI Comparescan output
The State File
The Preferences File
X RESOURCES: X11, .Xdefaults and AppDefaults


Getting Started

Getting Started


Starting DAI Comparescan


To invoke DAI Comprescan, enter the following command on the command line:

% comparescan [options]

A list of options which DAI Comparescan supports is displayed when the following command is typed:

% comparescan -h

The options are described below:
 
OptionDescription
-h -help -?Display the help options message
-v -versionDisplay DAI Comparescan and license manager version
-batchRun in batch mode. No GUI will be provided. You should specify a rules file on the command line.
-r 1Create a summary report on standard output. This will print the first 10 or so errors, sorted by time, in the error database. There is a space between "-r" and "1".
-r 2Create a full report on standard output. This will print all errors in the error database. There is a space between "-r" and "2".
-save <filename>Save the binary error database into filename at the end of comparison.
-p <filename>

-pref <filename>

Specify a preference file overriding the default of ~/.comparescan.pref
-state <filename>Specify a state file overriding the default of ~/.comparescan.state
-keyfile <filename>Specify an Evaluation Key File.
-f <filename>

-file <filename>

Specify a file to read command line options from.
-runRun comparison immediately upon startup.
-nobannerDo not display any text at startup.
-nogbannerDo not display any graphics banner at startup.
-hostidDisplay the host id for this machine.

DAI Comparescan always reads two files when it starts, the preferences file and the state file. They are usually ~/.comparescan.pref and ~/.comparescan.state respectively, although they can be overridden with command line options. These files can be removed at any time. If they are removed, all previous DAI Comparescan settings will be lost.

Rules and SST files on the command line


The rules file and the SST files may be specified on the command line. They are optional. If they are not specified, you can use the Compare Options Menu to specify them.

To specify a rules file that has SST references in it:

% comparescan completecompare.rules

To specify a rules file on the command line that does not have any SST file references:

% comparescan topcompare.rules adder1.sst \

adder1-fast.sst

You can run Comparescan without a GUI with the following options:

% comparescan -run completecompare.rules

DAI Comparescan Exit Codes


DAI Comparescan exits with either a 0 or 1 status code.

Exit code of 0 means that no mismatches were found.

Exit code of 1 means that some mismatches were found, some signals are missing, or some other error was detected.

Examining previously saved DAI Comparescan output


The error database that DAI Comparescan generates can be saved to a file for future reference. This file is a binary file that should not be editted. It is sometimes called the "csd" file for "Comparescan Database".

The binary error database can be loaded by using the GUI, File-->Open, or by specifying the file name on the command line. If the binary error database is specified on the command line, no rules file should be specified.

% comparescan completecompare.csd

The State File


DAI Comparescan saves data about its condition into a file located at ~/.comparescan.state. This file will contain the last set of options used when DAI Comparescan was run. It is also used to store information about which warning messages have previously been displayed to the user so that they are not repeatedly displayed.

The state file name and location can be overridden with the -state command line option.

Note this file should not be modified with an editor. It gets automatically updated when options are changed in the Command Options window. The state file does not store any of the comparison results information.

The Preferences File


DAI Comparescan saves the user selected preferences in a file named ~/.comparescan.pref. This file is saved when the user changes the preferences for the program.

The preferences file name and location can be overridden with the -pref command line option.

Note this file should not be modified by the user. Use the preferences dialog to modify its contents.

X RESOURCES: X11, .Xdefaults and AppDefaults


DAI Comparescan does not require an Appdefaults file. Too many problems are generated by Appdefaults files that are not up to date or cannot be accessed or could not be installed. DAI Comparescan will utilize resource settings from an Appdefaults file, but does not require that an Appdefaults file be installed. DAI Comparescan will also utilize resource settings set via xrdb or .Xdefaults. The following resources are used by DAI Comparescan. The default values are listed.

DAI Comparescan*foregroundcolor: #ffff00

DAI Comparescan*backgroundcolor: #6e6e6e

DAI Comparescan*selectcolor: #ff8080

DAI Comparescan*foregroundinactivecolor: #b0b000

DAI Comparescan*menufont: -*-helvetica-bold-r-*--12-*

DAI Comparescan*buttonfont: -*-helvetica-bold-r-*--14-*

DAI Comparescan*titlefont: -*-helvetica-bold-r-*--14-*

DAI Comparescan*userfont: -*-helvetica-medium-r-*--12-

DAI Comparescan*infofont: -*-helvetica-medium-r-*--11-*

DAI Comparescan*labelfont: -*-helvetica-medium-r-*--12-

DAI Comparescan*fixedfont: -*-fixed-medium-*-semicondensed-*-13-*

DAI Comparescan*dialogmessagefont: -*-helvetica-bold-r-*--14-*

If you change a setting in your .Xdefaults file, use xrdb to apply the changes to the running X server.



Next Prev Top Contents Index Home Page Send Feedback

DAI Comparescan User's Guide - Generated 26 FEB 1997
©Copyright 1997 Design Acceleration, Inc. All rights reserved