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.
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;
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;
-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);
-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;
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);
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;
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;
File with system-wide default settings for application preferences; system-wide settings are read on startup before user-specific settings;
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;