2.1 simics

OPTIONS

--batch-mode

Run in batch mode. This means that Simics will exit when all commands and scripts given on the command line have executed.

If an error has occurred, Simics will exit with a non-zero status. If all commands run to completion without any error, Simics exits with status 0, indicating success.

Simics will not use the command history file in batch mode.

--license

Print the Simics license text and exit. This is the default license and is also included in the LICENSE file.

--log-file FILE

Log issued CLI commands to a different file than the default. This implies -log (unless -no-log was specified).

--no-win

Disable external windows. This will prevent Simics from opening target console windows or any other external windows.

Disabling a target console only makes it invisible. It does not change its simulated functionality. Disabling it is useful when running in batch mode or when the target console isn’t needed, since it doesn’t require access to a graphical environment, and running with windows disabled is usually somewhat faster.

--script-trace

Show when a Simics script is entered/exited, along with any parameters passed to it and result variables returned from it.

--verbose

Make Simics more verbose. This makes Simics give ample details about the execution. This is the opposite of the --quiet flag. The quiet and verbose flags turn off each other. The default is somewhere in the middle with a “reasonable” output level.

Setting the verbose flag can be useful when solving problems with Simics. Some friendly warnings are not printed unless verbose is turned on.

Note that there will be quite a bit of information printed, most of which isn’t usually needed.

-e COMMAND or --execute COMMAND

Execute a CLI command. Equivalent of typing in the command at the command line prompt.

-h, --help

Makes Simics print a brief help screen and exit.

-q or --quiet

Make Simics less verbose. This makes Simics output less information, which is useful for batch execution. The opposite effect can be obtained with the --verbose flag. The quiet and verbose flags turn off each other. If you want Simics to be really quiet you can also give the --no-copyright flag.

Note that Simics is rather quiet by default, so this flag usually does not have much effect.

-v, --version, --base-version

Print the Simics version number and exit. Other information printed include the information of packages. --base-version only prints out Simics version.

-x

This flag has no effect and is kept for compatibility; it takes no arguments.

ADVANCED-OPTIONS

--echo

Enable command echoing. When echoing is enabled, Simics will echo all commands executed by startup scripts. Note that this only affects any startup scripts loaded after the -echo flag on the command line.

--module-path

Add a path to the directory list that Simics searches for modules.

--no-copyright

Do not display copyright information when starting Simics. See also the --verbose and --quiet flags.

--no-settings

Do not read any settings files, such as preferences.

--stop-on-error

Stop the simulation and interrupt the currently running script on error logs.

With this option, error logs with be treated as actual errors, and set the exit status accordingly when used in combination with --batch-mode.

-core

Allow Simics to dump core on fatal signals.

-dstc

Force the D-STC to be enabled. See the -no-stc flag for more information.

-istc

Force the I-STC to be enabled. See the -no-stc flag for more information.

-n, --no-startup

Do not run the commands from the startup-commands script files.

-no-dstc

Force the D-STC to be disabled. See the -no-stc flag for more information.

-no-istc

Force the I-STC to be disabled. See the -no-stc flag for more information.

-no-stc

Disable the Simics internal caches for memory operations and instruction fetches (STCs) that Simics uses to speed up the simulation.

Disabling the STCs (this flag disables both the D-STC and the I-STC) can be useful for debugging plug-ins such as cache models, since it will ensure that all memory accesses are fully visible.

It is possible to selectively disable the data and instruction STCs using the -no-dstc and -no-istc flags, respectively. The STCs are typically enabled by default, although in some versions of Simics they may be disabled. See also the -stc flag.

-python-verbose

Set the Python verbose flag. This will, for example, make Python print information when Python modules are being loaded. This is the same option as the -v flag in mini-python.

-stc

Force the I-STC and D-STC to be enabled (default). See the -no-stc flag for more information. The STCs are typically enabled by default, although in some versions of Simics they may be disabled.