sce_project

Name

sce_project -- scripting of System-On-Chip Environment (SCE)

Synopsis

sce_project [options] [action...] file

DESCRIPTION

sce_project allows to query and manipulate SCE project ("*.sce") files.

sce_project reads the given project file, performs each action specified via the command line and writes out the resulting modified project file. An output file is only written if modifications to the project have been made through the actions. If no action is specified, no operations are performed, no output is produced and the specified project is left unchanged.

On successful completion, the exit value 0 is returned. In case of errors, a diagnostic message is written to standard error and the program execution is aborted with a non-zero exit value. In this case, no output is produced.

ARGUMENTS

file

specifies the project file to work with; if no -i or -o options are specificed, this name is used as the the default project file to read and write, respectively; the suffix '.sce' will be appended to this name, if necessary;

action

specifies the action to perform on the project; actions include operations to query or manipulate the project; command line actions are processed strictly in order, i.e. multiple operations are performed in the order specified on the command line and later operations override earlier ones;

OPTIONS

-c

create new, empty project instead of reading existing project file on startup; overrides -i option;

-h

prints a short usage and version information and then quits;

-i input file

specifies the name of the input file explicitly; -c option;

-o output file

specifies the name of the output file explicitly;

-v

set the verbosity level so that progress reports about actions performed are logged to standard error (default: be silent);

ACTIONS

-a file[,[parent][,level]

add the design SIR file to the project; an error is produced if the specified SIR file does not exist; the design is added as a child of the given parent design (default: parent automatically determined from design's log/history or, if none, add at the top/root) with a given refinement level (default: level of parent plus one); levels can be specified in numeric (integer) or symbolic form; valid symbolic level names are: 'Arch', 'Sched', 'Net', 'TLM', 'Comm', 'FSMD', 'RTL', 'C', 'SW'/'ISS', 'RTLC', 'Impl';

-D

clear compiler macro definitions;

-D def

append def to the list of compiler macro definitions;

-e [command]

set simulation command to command; (default: reset to default command);

-I

clear compiler include path;

-I path

append path to the compiler include path;

-l

clear list of additional compiler libraries;

-l lib

append lib to the list of additional compiler libraries;

-L

clear compiler library search path;

-L path

append path to the compiler library search path;

-n

disable simulation logging;

-N

enable simulation logging;

-O options

set compiler options;

-P

clear compiler import search path;

-P path

append path to the compiler import search path;

-t [type]

set simulation terminal type (default: set to default, external terminal type); the terminal type can be specified in numeric (integer) or symbolic ('None', 'Viewer' 'Extern') form;

-T [terminal]

set command for external simulation terminal (default: reset to default command);

-U

clear compiler macro undefinitions;

-U undef

append undef to the list of compiler macro undefinitions;

ENVIRONMENT

HOME

determines the location of the user's home directory and consequently the default path to the file with user-specific application preferences ($HOME/.sce/scerc);

SCERC_PATH

determines the list of directories where files "scerc" with user-specific application preferences are stored; multiple directories can be provided, separated by colons (":"); directories are searched for and preference files are read in the given order, i.e. preference files in later directories override settings in earlier ones; if SCERC_PATH is not set, the location (directory) of the user-specific "scerc" file defaults to $HOME/.sce;

SPECC_LICENSE_FILE

determines the license file (path and file name) to be used by the SIR tool set; if undefined, the environment variable SPECC is used as the path to the license file called "license.sir"; if neither SPECC_LICENSE_FILE nor SPECC exist, the file "license.sir" is searched in the current directory;

FILES

/ECEnet/Apps1/sce/latest/etc/scerc

File with system-wide default settings for application preferences; system-wide settings are read on startup before user-specific settings;

$SCERC_PATH/scerc or $HOME/.sce/scerc

File(s) with user-specific settings for application preferences; user-specific settings are read on startup after system-wide settings, i.e. user-specific settings override system-wide settings;

VERSION

The System-On-Chip Environment (SCE) is version 2.2.1.

AUTHOR

Andreas Gerstlauer <gerstl@cecs.uci.edu>

COPYRIGHT

(c) 2001-2010 CECS, UC Irvine

SEE ALSO

sce_top(l), sce_import(l), sce_retype(l), sce_allocate(l), sce_map(l), sce_schedule(l), sce_connect(l),

BUGS, LIMITATIONS

None know.