VIRTUTECH CONFIDENTIAL    Previous - Up - Next

2.1   Startup Flags

-E, -expire <time> (advanced)

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

-L

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

-batch-mode (advanced)

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.

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

-central <address[:port]>

Connect to Simics Central. Simics Central may be running on another host, and this argument to this flag is an IP address and an optional port number where Simics Central is listening. The port number defaults to 1909 if omitted.

If the local hosts' address is supplied, and the port number is left out, Simics will try to connect to the default Unix file socket (/tmp/simics-central).

Also see the -central :<file> flag.

-central :<file>

Connect to Simics Central using a Unix file socket. This variant of the -central flag lets you specify a socket file.

-central-time-out <time>

Simics will wait time seconds trying to connect to a central server every second before giving up and starting without the central connection.

-dstc (advanced)

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

-e <command>

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

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

-fast

For backwards compatibility only. "Fast" mode is the default mode of execution.

-h

Makes Simics print a brief help screen and exit.

-istc (advanced)

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

-license

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

-license-file <file> (advanced)

Specify the FLEXlm license file to use. This will make Simics ignore the VTECH_LICENSE_FILE and LM_LICENSE_FILE environment variables. On Unix systems the $HOME/.flexlmlc file is ignored, as well as the Registry on Windows hosts. The $HOME/.flexlmrc, and the Registry are not updated when Simics is started with this flag.

-log-file <file>

Use a different log file than the default .simics-log.

-ma

Start micro-architect version of Simics if available. For more information about the micro-architect version, see the Simics User Guide. If you use this option, you typically want to run a micro-architect specific configuration and/or script as well.

-n

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

-no-copyright (advanced)

Do not print out copyright notices when starting Simics. See also the -verbose and -quiet flags.

-no-dstc (advanced)

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

-no-istc (advanced)

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

-no-log

Turns off logging to .simics-log (or any other file specified by -log-file).

-no-stc (advanced)

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

Disabling the STC:s (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 STC:s using the -no-dstc and -no-istc flags, respectively. The STC:s are typically enabled by default, although in some versions of Simics they may be disabled. See also the -stc flag.

-no-use-cygpath (advanced)

Disable Cygwin path translation. with this option set, Simics will not be able to load files specified with Cygwin syntax, or to follow symlinks created by Cygwin. Windows host only.

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

-obscure

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

-p <file>

Run code from a Python file.

-product <productname> (advanced)

Specify the licensed product to use. The chosen product specifies which models and capabilities you can use with Simics.

-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 doesn't do all that much.

-readme

Print the Simics README information and exit.

-stall

Start the stall version of Simics if available. For more information about this version and its limitations, see the Simics User Guide.

-stc (advanced)

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

-use-cygpath (advanced)

Enable Cygwin path translation. This is the default, and enables Simics to understand Cygwin paths ("/cygdrive/c/", for example), and translate them into native Windows form (C:\).

The translation is done internally, and behaves similar to the Cygwin cygpath utility. See the documentation for the SIM_native_path() API call for further details.

-v, -version, --version, -v-short

Print the Simics version number and exit. Other information printed include the compilers used and the compile-time options applied to this specific build. -v-short only prints out Simics version.

-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 to figure out problems that you may be having 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.

-werror (advanced)

Treat many warnings in Simics as errors and exit.

-workspace <workspace>

Specify the workspace directory to run Simics in.

-x <file>

Run commands from a script file. The script file is usually named with a .simics suffix.

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

VIRTUTECH CONFIDENTIAL    Previous - Up - Next