2.1 simics

--batch-mode Run in batch mode. This means that Simics will exit when all commands and scripts given on the command line have executed, or as soon as an error occurs.

When an error has occurred, Simics will immediately exit with a non-zero status. If all commands run to completion, 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.

-c FILE
Load a configuration file. This is equivalent to issuing a read-configuration command after Simics has started.

If this flag is the last on the command line, -c may be omitted.

-e COMMAND or --execute COMMAND Execute a CLI command. Equivalent of typing in the command at the command line prompt.

-gui
Start Simics in command line mode but allow the GUI to open windows.

-h, --help Makes Simics print a brief help screen and exit.

-log Turns on logging of issued CLI commands to the ~/.simics/6/log file on Linux and <APPDATA>\Roaming\Simics\6\log on Windows (or any other file specified by --log-file).

-no-gui
Start Simics in command line mode. No GUI windows will open except if explicitly requested using CLI commands.

-no-log

-obscure
Prints out a summary of advanced command line flags and exit.

-p FILE
Run code from a Python file.

-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.

--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.

--no-wdeprecated Turn off warnings about deprecated features.

--no-werror Do not treat warnings in Simics as errors. This is the default behavior but may have been disabled in the user preferences.

--wdeprecated Warn about all usage of deprecated features.

--werror Treat many warnings in Simics as errors and exit.

-E, -expire TIME
Check out licenses with an expire time, for off-line use. Valid formats are:

• dd-mmm-yyyy[:hh:mm] – where:

  • dd
    day number in month
  • mmm
    abbreviated name of month
  • yyyy
    year including century
  • hh
    hour in 24-hour format
  • mm
    minutes.

• +<num>h – setting the license to expire <num> hours from now.

• +<num>d – setting the license to expire <num> days from now.

-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.