CSLS

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
CONFIGURATION FILE
EXAMPLES
FILES
SEE ALSO

NAME

csls - put a SLS network description into the database

-I

Interactive mode for circuit equivalence selection (functional mode only).

-d

Generate dummy circuit design object for all instantiated functional blocks. Will overwrite an existing working version of the circuit (functional mode only).

-p

Run the C preprocessor before parsing the input file.

-s

The silent mode suppresses messages about the actions taken by the program which are usually printed on the screen.

-w

Do not print warnings.

DESCRIPTION

Csls is a program that generates from an sls network description a circuit description in database format. The database format can serve as input to several application programs, e.g. the switch-level simulator sls. A description of the sls language can be found in "SLS: Switch-Level Simulator User's Manual".

A network description can be hierarchical and may reside in several files. However, when one particular network is added to the database, network descriptions of the networks that are called in the network must have been added to the database before.

In the file 'global_nets' one may optionally specify names of nets (terminals) that are global. Each node or terminal that has a name equal to the name of a global net, will be connected to other nodes and terminals that have the same name, among other things by possibly defining extra terminals for each network. First, csls will try to find a file 'global_nets' in the current working directory. Second, if the above attempt fails, csls will try to open a file 'global_nets' in the corresponding process directory.

CONFIGURATION FILE

At start-up of the program, csls will read some information from a configuration file called ".cslsrc". First, it tries to read this file from the process directory (without leading dot). Second, it tries to read this file from the home directory of the user. Thirdly, it tries to read this file from the current directory. Settings in the second and third configuration file overrule the previous settings. The configuration file may contain the following keywords, followed by a specification on the same line if the keyword ends with ':';

EXTERN_OBLIGATORY_ON

Generate an error message if an extern network declaration for a sub-network does not exist.

EXTERN_OBLIGATORY_OFF

Don't generate an error message (default mode).

FORBID_FIRST_CAPITAL_ON

Generate an error message if the name of a network that is defined starts with a capital.

FORBID_FIRST_CAPITAL_OFF

Don't generate an error message (default mode).

RUN_CPP_ON

Run the C preprocessor before parsing the input file.

RUN_CPP_OFF

Don't run the C preprocessor (default mode).

CPP:

Specifies the invocation of the C preprocessor. Default, csls tries to use "/usr/lib/cpp", "/lib/cpp" or "cc -E" (in that order).

CPP_OPTIONS:

Options for running the C preprocessor (default none).

DEFAULT_INCLUDE:

Specifies a file that is automatically included at the top of the input file if the C preprocessor is run (default: no include).

EXAMPLES

$ csls latch.sls

FILES

.cslsrc

(2nd altern.) configuration file

HOME/.cslsrc

(1st altern.) configuration file

ICDPATH/share/lib/process/process/cslsrc

(default) configuration file

global_nets

(default) file to specify global nets

ICDPATH/share/lib/process/process/global_nets

(altern.) file to specify global nets

/usr/tmp/x*

temporary files

	-I		Interactive mode for circuit equivalence selection (functional mode only).
	-d		Generate dummy circuit design object for all instantiated functional blocks. Will overwrite an existing working version of the circuit (functional mode only).
	-p		Run the C preprocessor before parsing the input file.
	-s		The silent mode suppresses messages about the actions taken by the program which are usually printed on the screen.
	-w		Do not print warnings.