II Feature Overview 4 The Command Line Interface
Simics User's Guide  /  II Feature Overview  / 

3 Using Simics from the Command Line

This chapter describes command line options accepted by Simics.

Even on Windows hosts, running Simics from the command line is useful. For example, when running automatic test scripts, profiling or benchmarking. Whole test sessions can be automated using the CLI or Python, and executed directly from the Window command shell.

Below is an example on how Simics can be started from the command line using a Simics project.

Windows
Run the simics.bat script in your project directory.
[project]> simics.bat targets\qsp-x86\firststeps.simics

Linux
Run the ./simics script in your project directory.
joe@computer:[project]$ ./simics targets/qsp-x86/firststeps.simics

Simics can also be started by running a similar start script in the [simics]\bin directory ([simics]/bin on Linux). This will run Simics without a project, and is usually not recommended.

This will run the firststeps.simics script, which will start the QSP-x86 machine using its default configuration.

To quit the Simics shell you can type quit at the Simics prompt.

The full set of command line options are documented in Simics Reference Manual.

II Feature Overview 4 The Command Line Interface