VIRTUTECH CONFIDENTIAL    Previous - Up - Next

4.2   By Categories

Breakpoints

<breakpoint>.break set breakpoint
<processor>.cycle-break-absolute set absolute cycle breakpoint
<processor>.step-break-absolute set absolute time breakpoint
cycle-break-absolute set absolute cycle breakpoint
delete remove a breakpoint
enable enable/disable breakpoint
ignore set ignore count for a breakpoint
list-breakpoints print information about breakpoints
magic-break-enable install magic instruction hap handler
set-pattern set an instruction pattern for a breakpoint
set-prefix set a syntax prefix for a breakpoint
set-substr set a syntax substring for a breakpoint
step-break-absolute set absolute time breakpoint
unbreak remove breakpoint range

CD-ROM

<file-cdrom>.delete delete an unused file-cdrom object
<host-cdrom>.delete delete an unused host-cdrom object
new-file-cdrom create new file-cdrom object
new-host-cdrom create new host-cdrom object

Changing Simulated State

<image>.set set bytes in image to specified value
<processor>.write-reg write to register
load-binary load binary (executable) file into memory
load-file load file into memory
penable switch processor on
set set physical address to specified value
set-pc set the current processor's program counter
write-reg write to register

Command-Line Interface

! execute a shell command
!= not equal
$ get the value of an environment variable
& bitwise AND operation
* arithmetic multiplication
+ arithmetic addition
+= set an environment variable
- arithmetic subtraction
-= set an environment variable
-> access object attribute
/ arithmetic division
< less than
<< bitwise left shift
<= less or equal
= set an environment variable
== equal
> greater than
>= greater or equal
>> bitwise right shift
@ evaluate a Python statement
[
^ bitwise XOR operation
and logical and
cd change working directory
current-processor return current processor
date host time and date
defined variable defined
digit-grouping set output formatting for numbers
dirs display directory stack
disassemble-settings change disassembly output settings
display print expression at prompt
echo echo a value to screen
else
hex display integer in hexadecimal notation
if
list-namespaces list all namespaces
list-vars list environment variables
ls list files
max max
min min
not logical not
or logical or
output-radix change the default output radix
pid print pid of Simics process
pipe run commands through a pipe
popd pop directory from directory stack
pow power of
print display integer in various bases
pselect select a processor
pushd push directory on directory stack
pwd print working directory
python evaluate an expression in python
quit quit from Simics
run-command-file execute a simics script
run-python-file execute Python file
script-branch
signed interpret unsigned integer as signed
signed16 interpret unsigned integer as signed
signed32 interpret unsigned integer as signed
signed64 interpret unsigned integer as signed
signed8 interpret unsigned integer as signed
undisplay remove expression installed by display
unset remove a environment variable
while
| bitwise OR operation
~ bitwise not

Components

<component>.connect connect components
<component>.disconnect disconnect component connector
<component>.get-component-object get named object from components
connect-components connect components
create-agp-voodoo3 create a non-instantiated agp-voodoo3
create-alpha-lx164-system create a non-instantiated alpha-lx164-system
create-and-connect-ddr-memory create and connect memory modules to the system
create-arm-sa1110-system create a non-instantiated arm-sa1110-system
create-ddr-memory-module create a non-instantiated ddr-memory-module
create-ddr2-memory-module create a non-instantiated ddr2-memory-module
create-dummy-component create a non-instantiated dummy-component
create-ebony-board create a non-instantiated ebony-board
create-enchilada-system create a non-instantiated enchilada-system
create-i386-cpu create a non-instantiated i386-cpu
create-i486dx2-cpu create a non-instantiated i486dx2-cpu
create-i486sx-cpu create a non-instantiated i486sx-cpu
create-ia64-460gx-system create a non-instantiated ia64-460gx-system
create-isa-lance create a non-instantiated isa-lance
create-isa-vga create a non-instantiated isa-vga
create-itanium-cpu create a non-instantiated itanium-cpu
create-legacy-pc-devices create a non-instantiated legacy-pc-devices
create-leon2-simple create a non-instantiated leon2-simple
create-malta-system create a non-instantiated malta-system
create-niagara-simple-system create a non-instantiated niagara-simple-system
create-north-bridge-443bx create a non-instantiated north-bridge-443bx
create-north-bridge-443bx-agp create a non-instantiated north-bridge-443bx-agp
create-north-bridge-875p create a non-instantiated north-bridge-875p
create-north-bridge-e7520 create a non-instantiated north-bridge-e7520
create-north-bridge-k8 create a non-instantiated north-bridge-k8
create-opteron-cpu create a non-instantiated opteron-cpu
create-pc-dual-serial-ports create a non-instantiated pc-dual-serial-ports
create-pc-floppy-controller create a non-instantiated pc-floppy-controller
create-pc-quad-serial-ports create a non-instantiated pc-quad-serial-ports
create-pc-single-parallel-port create a non-instantiated pc-single-parallel-port
create-pci-am79c973 create a non-instantiated pci-am79c973
create-pci-backplane create a non-instantiated pci-backplane
create-pci-bcm5703c create a non-instantiated pci-bcm5703c
create-pci-bcm5704c create a non-instantiated pci-bcm5704c
create-pci-dec21041 create a non-instantiated pci-dec21041
create-pci-dec21140a create a non-instantiated pci-dec21140a
create-pci-dec21140a-dml create a non-instantiated pci-dec21140a-dml
create-pci-dec21143 create a non-instantiated pci-dec21143
create-pci-i21152 create a non-instantiated pci-i21152
create-pci-i82543gc create a non-instantiated pci-i82543gc
create-pci-i82546bg create a non-instantiated pci-i82546bg
create-pci-isp1040 create a non-instantiated pci-isp1040
create-pci-isp2200 create a non-instantiated pci-isp2200
create-pci-pd6729 create a non-instantiated pci-pd6729
create-pci-pmc1553-bc create a non-instantiated pci-pmc1553-bc
create-pci-rage-pm-mobility-pci create a non-instantiated pci-rage-pm-mobility-pci
create-pci-ragexl create a non-instantiated pci-ragexl
create-pci-sil680a create a non-instantiated pci-sil680a
create-pci-sym53c810 create a non-instantiated pci-sym53c810
create-pci-sym53c875 create a non-instantiated pci-sym53c875
create-pci-sym53c876 create a non-instantiated pci-sym53c876
create-pci-vga create a non-instantiated pci-vga
create-pci-voodoo3 create a non-instantiated pci-voodoo3
create-pcie-pex8524 create a non-instantiated pcie-pex8524
create-pcie-pex8524-nt create a non-instantiated pcie-pex8524-nt
create-pentium-4-cpu create a non-instantiated pentium-4-cpu
create-pentium-4e-2ht-cpu create a non-instantiated pentium-4e-2ht-cpu
create-pentium-4e-4ht-cpu create a non-instantiated pentium-4e-4ht-cpu
create-pentium-4e-cpu create a non-instantiated pentium-4e-cpu
create-pentium-cpu create a non-instantiated pentium-cpu
create-pentium-ii-cpu create a non-instantiated pentium-ii-cpu
create-pentium-iii-cpu create a non-instantiated pentium-iii-cpu
create-pentium-m-cpu create a non-instantiated pentium-m-cpu
create-pentium-mmx-cpu create a non-instantiated pentium-mmx-cpu
create-pentium-pro-cpu create a non-instantiated pentium-pro-cpu
create-phy-mii-transceiver create a non-instantiated phy-mii-transceiver
create-pmppc-board create a non-instantiated pmppc-board
create-ppc-simple create a non-instantiated ppc-simple
create-ppc970-simple create a non-instantiated ppc970-simple
create-ps2-keyboard-mouse create a non-instantiated ps2-keyboard-mouse
create-sample-gcache create a non-instantiated sample-gcache
create-sample-ma-model create a non-instantiated sample-ma-model
create-sample-ooo-model create a non-instantiated sample-ooo-model
create-sample-x86-ma-model create a non-instantiated sample-x86-ma-model
create-sdram-memory-module create a non-instantiated sdram-memory-module
create-serengeti-3800-chassis create a non-instantiated serengeti-3800-chassis
create-serengeti-4800-chassis create a non-instantiated serengeti-4800-chassis
create-serengeti-4810-chassis create a non-instantiated serengeti-4810-chassis
create-serengeti-6800-chassis create a non-instantiated serengeti-6800-chassis
create-serengeti-cluster-chassis create a non-instantiated serengeti-cluster-chassis
create-serengeti-cpci4-board create a non-instantiated serengeti-cpci4-board
create-serengeti-pci8-board create a non-instantiated serengeti-pci8-board
create-serengeti-sp-cpci6-board create a non-instantiated serengeti-sp-cpci6-board
create-serengeti-us-iii-cpu-board create a non-instantiated serengeti-us-iii-cpu-board
create-serengeti-us-iii-plus-cpu-board create a non-instantiated serengeti-us-iii-plus-cpu-board
create-serengeti-us-iv-cpu-board create a non-instantiated serengeti-us-iv-cpu-board
create-serengeti-us-iv-plus-cpu-board create a non-instantiated serengeti-us-iv-plus-cpu-board
create-simple-fc-disk create a non-instantiated simple-fc-disk
create-sio-lpc47m172 create a non-instantiated sio-lpc47m172
create-sio-w83627hf create a non-instantiated sio-w83627hf
create-south-bridge-6300esb create a non-instantiated south-bridge-6300esb
create-south-bridge-amd8111 create a non-instantiated south-bridge-amd8111
create-south-bridge-md1535d create a non-instantiated south-bridge-md1535d
create-south-bridge-piix4 create a non-instantiated south-bridge-piix4
create-south-bridge-saturn create a non-instantiated south-bridge-saturn
create-south-bridge-sun-md1535d create a non-instantiated south-bridge-sun-md1535d
create-std-etg create a non-instantiated std-etg
create-std-ethernet-link create a non-instantiated std-ethernet-link
create-std-graphics-console create a non-instantiated std-graphics-console
create-std-host-serial-console create a non-instantiated std-host-serial-console
create-std-ide-cdrom create a non-instantiated std-ide-cdrom
create-std-ide-disk create a non-instantiated std-ide-disk
create-std-ms1553-link create a non-instantiated std-ms1553-link
create-std-pcmcia-flash-disk create a non-instantiated std-pcmcia-flash-disk
create-std-scsi-bus create a non-instantiated std-scsi-bus
create-std-scsi-cdrom create a non-instantiated std-scsi-cdrom
create-std-scsi-disk create a non-instantiated std-scsi-disk
create-std-serial-link create a non-instantiated std-serial-link
create-std-server-console create a non-instantiated std-server-console
create-std-service-node create a non-instantiated std-service-node
create-std-super-io create a non-instantiated std-super-io
create-std-text-console create a non-instantiated std-text-console
create-std-text-graphics-console create a non-instantiated std-text-graphics-console
create-sun-cpci-hme-isp create a non-instantiated sun-cpci-hme-isp
create-sun-cpci-isp-isp create a non-instantiated sun-cpci-isp-isp
create-sun-cpci-qlc-qlc create a non-instantiated sun-cpci-qlc-qlc
create-sun-pci-ce create a non-instantiated sun-pci-ce
create-sun-pci-hme create a non-instantiated sun-pci-hme
create-sun-pci-hme-isp create a non-instantiated sun-pci-hme-isp
create-sun-pci-pgx64 create a non-instantiated sun-pci-pgx64
create-sun-pci-qlc create a non-instantiated sun-pci-qlc
create-sun-pci-qlc-qlc create a non-instantiated sun-pci-qlc-qlc
create-sun-sbus-fas-hme create a non-instantiated sun-sbus-fas-hme
create-sun-type5-keyboard create a non-instantiated sun-type5-keyboard
create-sun-type5-mouse create a non-instantiated sun-type5-mouse
create-sunfire-3500-backplane create a non-instantiated sunfire-3500-backplane
create-sunfire-4500-backplane create a non-instantiated sunfire-4500-backplane
create-sunfire-6500-backplane create a non-instantiated sunfire-6500-backplane
create-sunfire-cpu-board create a non-instantiated sunfire-cpu-board
create-sunfire-pci-board create a non-instantiated sunfire-pci-board
create-sunfire-sbus-board create a non-instantiated sunfire-sbus-board
create-taco-system create a non-instantiated taco-system
create-telos-mote create a non-instantiated telos-mote
create-x86-apic-bus-system create a non-instantiated x86-apic-bus-system
create-x86-apic-system create a non-instantiated x86-apic-system
create-x86-e7520-system create a non-instantiated x86-e7520-system
create-x86-hammer-cpu create a non-instantiated x86-hammer-cpu
create-x86-separate-mem-io-system create a non-instantiated x86-separate-mem-io-system
create-x86-system create a non-instantiated x86-system
get-component-prefix get current component name prefix
import-alpha-components import a component collection
import-arm-sa1110-components import a component collection
import-arm-t-engine-components import a component collection
import-blue-logic-components import a component collection
import-cpp8260-components import a component collection
import-fiesta-components import a component collection
import-fsp1-components import a component collection
import-ia64-components import a component collection
import-isa-components import a component collection
import-leon2-components import a component collection
import-malta-components import a component collection
import-memory-components import a component collection
import-mpc8260-components import a component collection
import-mpc8360e-components import a component collection
import-mpc8540-components import a component collection
import-mpc8548-components import a component collection
import-mpc8555-components import a component collection
import-mpc8641-components import a component collection
import-niagara-simple-components import a component collection
import-pci-components import a component collection
import-phy-components import a component collection
import-pmppc-components import a component collection
import-power6-simple-components import a component collection
import-ppc-mv64360-components import a component collection
import-ppc-simple-components import a component collection
import-ppc405gp-components import a component collection
import-ppc440gp-components import a component collection
import-ppc64-simple-components import a component collection
import-rad750-components import a component collection
import-serengeti-components import a component collection
import-std-components import a component collection
import-sun-components import a component collection
import-sunfire-components import a component collection
import-telos-mote-components import a component collection
import-timing-components import a component collection
import-usb-components import a component collection
import-x86-components import a component collection
instantiate-components instantiate components
list-components list components
new-arm-sa1110-system create an instantiated arm-sa1110-system
new-ddr-memory-module create an instantiated ddr-memory-module
new-ddr2-memory-module create an instantiated ddr2-memory-module
new-dummy-component create an instantiated dummy-component
new-ebony-board create an instantiated ebony-board
new-ia64-460gx-system create an instantiated ia64-460gx-system
new-leon2-simple create an instantiated leon2-simple
new-niagara-simple-system create an instantiated niagara-simple-system
new-pmppc-board create an instantiated pmppc-board
new-ppc-simple create an instantiated ppc-simple
new-ppc970-simple create an instantiated ppc970-simple
new-sample-gcache create an instantiated sample-gcache
new-sample-ma-model create an instantiated sample-ma-model
new-sample-ooo-model create an instantiated sample-ooo-model
new-sample-x86-ma-model create an instantiated sample-x86-ma-model
new-sdram-memory-module create an instantiated sdram-memory-module
new-serengeti-3800-chassis create an instantiated serengeti-3800-chassis
new-serengeti-4800-chassis create an instantiated serengeti-4800-chassis
new-serengeti-4810-chassis create an instantiated serengeti-4810-chassis
new-serengeti-6800-chassis create an instantiated serengeti-6800-chassis
new-serengeti-cluster-chassis create an instantiated serengeti-cluster-chassis
new-south-bridge-6300esb create an instantiated south-bridge-6300esb
new-std-etg create an instantiated std-etg
new-std-ethernet-link create an instantiated std-ethernet-link
new-std-graphics-console create an instantiated std-graphics-console
new-std-host-serial-console create an instantiated std-host-serial-console
new-std-ms1553-link create an instantiated std-ms1553-link
new-std-pcmcia-flash-disk create an instantiated std-pcmcia-flash-disk
new-std-serial-link create an instantiated std-serial-link
new-std-server-console create an instantiated std-server-console
new-std-service-node create an instantiated std-service-node
new-std-text-console create an instantiated std-text-console
new-std-text-graphics-console create an instantiated std-text-graphics-console
new-sun-type5-keyboard create an instantiated sun-type5-keyboard
new-sun-type5-mouse create an instantiated sun-type5-mouse
new-telos-mote create an instantiated telos-mote
set-component-prefix set a prefix for all component names

Configuration

<image>.add-diff-file add a diff file to the image
<image>.add-partial-diff-file add a partial diff file to the image
<image>.save save image to disk
<image>.save-diff-file save changes since last checkpoint
<memory-space>.add-map map device in a memory-space
<memory-space>.del-map remove device map from a memory-space
<memory-space>.map list memory map
<port-space>.add-map map device in a port-space
<port-space>.del-map remove device map from a port-space
<port-space>.map list port map
add-directory add a directory to the Simics search path
add-module-directory add a directory to the module search path
devs list all devices in Simics
list-attributes list all attributes
list-classes list all configuration classes
list-failed-modules list the modules that are not loadable
list-modules list loadable modules
list-objects list all objects
load-module load module into Simics
load-persistent-state load persistent state
module-list-refresh create a new list of loadable modules
read-configuration restore configuration
save-component-template save a component configuration template
save-persistent-state save persistent simulator state
unload-module unload module
write-configuration save configuration

Debugging

<breakpoint>.break set breakpoint
<context-switcher>.track-bin track first use of a given binary
<context-switcher>.track-pid track the process with a given pid
<context>.finish-function finish the current function
<context>.next-instruction run to the next instruction, skipping subroutine calls
<context>.next-line run to the next source line, skipping subroutine calls
<context>.on switch on context object
<context>.reverse-next-instruction back to the previous instruction, skipping subroutine calls
<context>.reverse-next-line back to the previous source line, skipping subroutine calls
<context>.reverse-step-instruction back to the previous instruction
<context>.reverse-step-line back to the previous source line
<context>.step-instruction run to the next instruction
<context>.step-line run to the next source line
<context>.uncall-function go back to when the current function was called
<linux-process-tracker>.process-list list running processes
<processor>.cycle-break-absolute set absolute cycle breakpoint
<processor>.step-break-absolute set absolute time breakpoint
cycle-break-absolute set absolute cycle breakpoint
delete remove a breakpoint
enable enable/disable breakpoint
finish-function finish the current function
gdb-remote start gdb-remote
ignore set ignore count for a breakpoint
list-breakpoints print information about breakpoints
magic-break-enable install magic instruction hap handler
new-context create a new context
new-gdb-remote create a gdb session
next-instruction run to the next instruction, skipping subroutine calls
next-line run to the next source line, skipping subroutine calls
reverse-next-instruction back to the previous instruction, skipping subroutine calls
reverse-next-line back to the previous source line, skipping subroutine calls
reverse-step-line back to the previous source line
set-context set the current context of a CPU
set-pattern set an instruction pattern for a breakpoint
set-prefix set a syntax prefix for a breakpoint
set-substr set a syntax substring for a breakpoint
step-break-absolute set absolute time breakpoint
step-line run to the next source line
unbreak remove breakpoint range
uncall-function go back to when the current function was called

Disk

<image>.add-diff-file add a diff file to the image
<image>.add-partial-diff-file add a partial diff file to the image
<image>.save save image to disk
<image>.save-diff-file save changes since last checkpoint
<image>.set set bytes in image to specified value
load-persistent-state load persistent state
new-file-cdrom create new file-cdrom object
new-host-cdrom create new host-cdrom object
save-persistent-state save persistent simulator state

Distributed Simulation

connect-central connect to Simics Central
new-central-server create a Simics Central server

Ethernet

<AM79C960-dml>.connect connect to a simulated Ethernet link
<AM79C960-dml>.disconnect disconnect from simulated link
<AM79C960>.connect connect to a simulated Ethernet link
<AM79C960>.disconnect disconnect from simulated link
<AM79C973>.connect connect to a simulated Ethernet link
<AM79C973>.disconnect disconnect from simulated link
<BCM5703C>.connect connect to a simulated Ethernet link
<BCM5703C>.disconnect disconnect from simulated link
<BCM5704C>.connect connect to a simulated Ethernet link
<BCM5704C>.disconnect disconnect from simulated link
<cassini>.connect connect to a simulated Ethernet link
<cassini>.disconnect disconnect from simulated link
<cheerio-hme>.connect connect to a simulated Ethernet link
<cheerio-hme>.disconnect disconnect from simulated link
<CS8900A>.connect connect to a simulated Ethernet link
<CS8900A>.disconnect disconnect from simulated link
<DEC21041>.connect connect to a simulated Ethernet link
<DEC21041>.disconnect disconnect from simulated link
<DEC21140A>.connect connect to a simulated Ethernet link
<DEC21140A>.disconnect disconnect from simulated link
<DEC21143>.connect connect to a simulated Ethernet link
<DEC21143>.disconnect disconnect from simulated link
<eth-transceiver>.connect connect to a simulated Ethernet link
<eth-transceiver>.disconnect disconnect from simulated link
<mii-transceiver>.connect connect to a simulated Ethernet link
<mii-transceiver>.disconnect disconnect from simulated link
<ppc405gp-emac>.connect connect to a simulated Ethernet link
<ppc405gp-emac>.disconnect disconnect from simulated link
<ppc440gp-emac>.connect connect to a simulated Ethernet link
<ppc440gp-emac>.disconnect disconnect from simulated link
<ppc440gx-emac>.connect connect to a simulated Ethernet link
<ppc440gx-emac>.disconnect disconnect from simulated link
<sbus-hme>.connect connect to a simulated Ethernet link
<sbus-hme>.disconnect disconnect from simulated link
new-etg Create an Ethernet traffic generator
new-ethernet-link create a new ethernet link
new-service-node create a new service node

Execution

<processor>.cycle-break-absolute set absolute cycle breakpoint
<processor>.disassemble disassemble instructions
<processor>.instruction-fetch-mode set or get current mode for instruction fetching
<processor>.print-time print number of steps and cycles executed
<processor>.step-break-absolute set absolute time breakpoint
cpu-switch-time get/set CPU switch time
cycle-break-absolute set absolute cycle breakpoint
disassemble disassemble instructions
disassemble-settings change disassembly output settings
enable-real-time-mode set real time mode for Simics
instruction-fetch-mode set or get current mode for instruction fetching
istc-enable enable I-STC
load-binary load binary (executable) file into memory
penable switch processor on
print-time print number of steps and cycles executed
pstatus show processors' status
run start execution
run-cycles start execution
set-pc set the current processor's program counter
step-break-absolute set absolute time breakpoint
step-cycle step one or more cycles
step-cycle-single step one cycle and switch to the next cpu
step-instruction step one or more instructions
stop interrupt simulation

Files and Directories

add-directory add a directory to the Simics search path
add-module-directory add a directory to the module search path
cd change working directory
clear-directories clear the Simics search path
dirs display directory stack
list-directories list directories in Simics search path
ls list files
native-path convert a filename to host native form
output-file-start send output to file
output-file-stop stop sending output to file
popd pop directory from directory stack
pushd push directory on directory stack
pwd print working directory
resolve-file resolve a filename
run-command-file execute a simics script
run-python-file execute Python file

Haps

list-hap-callbacks print list of hap callbacks
list-haps print list of haps

Help

api-apropos search API help
api-help get API help
command-list generate html document describing commands
copyright print full Simics copyright information
help help command
license print simics license
list-attributes list all attributes
list-namespaces list all namespaces
readme print information about Simics
version display Simics version

Inspecting Simulated State

% read register by name
<image>.x examine image data
<memory-space>.map list memory map
<port-space>.map list port map
<processor>.disassemble disassemble instructions
<processor>.logical-to-physical translate logical address to physical
<processor>.pregs print cpu registers
<processor>.read-reg read a register
<processor>.register-number get the number of a processor register
<processor>.x examine raw memory contents
devs list all devices in Simics
disassemble disassemble instructions
get get value of physical address
logical-to-physical translate logical address to physical
pregs print cpu registers
print-event-queue print event queue for processor
pstatus show processors' status
read-reg read a register
x examine raw memory contents

Logging

<log_object>.log print log entries for all objects
<log_object>.log-group set or get the current log groups
<log_object>.log-level set or get the log level
<log_object>.log-size set log buffer size
<log_object>.log-type set or get the current log types
log print log entries for all objects
log-level set or get the global log level
log-setup configure log behavior
log-size set log buffer size
log-type set or get the current log types

Memory

<image>.add-diff-file add a diff file to the image
<image>.add-partial-diff-file add a partial diff file to the image
<image>.save save image to disk
<image>.save-diff-file save changes since last checkpoint
<image>.set set bytes in image to specified value
<image>.x examine image data
<memory-space>.add-map map device in a memory-space
<memory-space>.del-map remove device map from a memory-space
<memory-space>.map list memory map
<port-space>.add-map map device in a port-space
<port-space>.del-map remove device map from a port-space
<port-space>.map list port map
<processor>.add-memory-profiler add a memory profiler to the processor
<processor>.disassemble disassemble instructions
<processor>.list-memory-profilers list memory profilers connected to the processor
<processor>.logical-to-physical translate logical address to physical
<processor>.remove-memory-profiler remove a memory profiler from the processor
<processor>.x examine raw memory contents
disassemble disassemble instructions
disassemble-settings change disassembly output settings
get get value of physical address
load-binary load binary (executable) file into memory
load-file load file into memory
logical-to-physical translate logical address to physical
set set physical address to specified value
x examine raw memory contents

Modules

add-module-directory add a directory to the module search path
list-failed-modules list the modules that are not loadable
list-modules list loadable modules
load-module load module into Simics
module-list-refresh create a new list of loadable modules
unload-module unload module

Networking

<AM79C960-dml>.connect connect to a simulated Ethernet link
<AM79C960-dml>.disconnect disconnect from simulated link
<AM79C960>.connect connect to a simulated Ethernet link
<AM79C960>.disconnect disconnect from simulated link
<AM79C973>.connect connect to a simulated Ethernet link
<AM79C973>.disconnect disconnect from simulated link
<BCM5703C>.connect connect to a simulated Ethernet link
<BCM5703C>.disconnect disconnect from simulated link
<BCM5704C>.connect connect to a simulated Ethernet link
<BCM5704C>.disconnect disconnect from simulated link
<cassini>.connect connect to a simulated Ethernet link
<cassini>.disconnect disconnect from simulated link
<cheerio-hme>.connect connect to a simulated Ethernet link
<cheerio-hme>.disconnect disconnect from simulated link
<CS8900A>.connect connect to a simulated Ethernet link
<CS8900A>.disconnect disconnect from simulated link
<DEC21041>.connect connect to a simulated Ethernet link
<DEC21041>.disconnect disconnect from simulated link
<DEC21140A>.connect connect to a simulated Ethernet link
<DEC21140A>.disconnect disconnect from simulated link
<DEC21143>.connect connect to a simulated Ethernet link
<DEC21143>.disconnect disconnect from simulated link
<eth-transceiver>.connect connect to a simulated Ethernet link
<eth-transceiver>.disconnect disconnect from simulated link
<ethernet-link>.connect-real-network-bridge connect to the real network
<ethernet-link>.connect-real-network-host connect to the real network
<ethernet-link>.connect-real-network-napt enable NAPT from simulated network
<ethernet-link>.connect-real-network-router connect to the real network
<ethernet-link>.disconnect-real-network disconnect from the real network
<mii-transceiver>.connect connect to a simulated Ethernet link
<mii-transceiver>.disconnect disconnect from simulated link
<ppc405gp-emac>.connect connect to a simulated Ethernet link
<ppc405gp-emac>.disconnect disconnect from simulated link
<ppc440gp-emac>.connect connect to a simulated Ethernet link
<ppc440gp-emac>.disconnect disconnect from simulated link
<ppc440gx-emac>.connect connect to a simulated Ethernet link
<ppc440gx-emac>.disconnect disconnect from simulated link
<sbus-hme>.connect connect to a simulated Ethernet link
<sbus-hme>.disconnect disconnect from simulated link
connect-real-network-bridge connect bridge between real and simulated network
connect-real-network-host connect real host to the simulated network
connect-real-network-router connect router between real and simulated network
disconnect-real-network disconnect from the real network
network-helper set/show name of host network helper
new-ethernet-link create a new ethernet link

Output

<log_object>.log print log entries for all objects
<log_object>.log-group set or get the current log groups
<log_object>.log-level set or get the log level
<log_object>.log-size set log buffer size
<log_object>.log-type set or get the current log types
digit-grouping set output formatting for numbers
disassemble-settings change disassembly output settings
display print expression at prompt
echo echo a value to screen
hex display integer in hexadecimal notation
log print log entries for all objects
log-level set or get the global log level
log-setup configure log behavior
log-size set log buffer size
log-type set or get the current log types
output-radix change the default output radix
pipe run commands through a pipe
print display integer in various bases
signed interpret unsigned integer as signed
signed16 interpret unsigned integer as signed
signed32 interpret unsigned integer as signed
signed64 interpret unsigned integer as signed
signed8 interpret unsigned integer as signed
undisplay remove expression installed by display

Profiling

<address_profiler>.address-profile-data linear map of address profiling data
<address_profiler>.address-profile-info general info about an address profiler
<address_profiler>.address-profile-toplist print toplist of address profiling data
<branch_recorder>.clean delete all branch arcs in the branch recorder
<branch_recorder>.print-branch-arcs print branch arcs
<data-profiler>.clear clear data profiler
<processor>.add-memory-profiler add a memory profiler to the processor
<processor>.aprof-views manipulate list of selected address profiling views
<processor>.attach-branch-recorder attach a branch recorder to a processor
<processor>.detach-branch-recorder detach a branch recorder from a processor
<processor>.instruction-fetch-mode set or get current mode for instruction fetching
<processor>.list-memory-profilers list memory profilers connected to the processor
<processor>.print-time print number of steps and cycles executed
<processor>.remove-memory-profiler remove a memory profiler from the processor
<processor>.start-instruction-profiling get started with instruction profiling
function-profile list functions sorted by profile counts
instruction-fetch-mode set or get current mode for instruction fetching
magic-break-enable install magic instruction hap handler
new-branch-recorder create a new branch recorder
print-statistics print various statistics
print-time print number of steps and cycles executed
select-profiles set profilers to display in source listing

Python

@ evaluate a Python statement
else
if
python evaluate an expression in python
run-python-file execute Python file
script-branch
while

Real Network

<ethernet-link>.connect-real-network-bridge connect to the real network
<ethernet-link>.connect-real-network-host connect to the real network
<ethernet-link>.connect-real-network-napt enable NAPT from simulated network
<ethernet-link>.connect-real-network-router connect to the real network
<ethernet-link>.disconnect-real-network disconnect from the real network
close-tun-tap-interface close an unused persistent TUN/TAP interface
connect-real-network connect a simulated machine to the real network
connect-real-network-bridge connect bridge between real and simulated network
connect-real-network-host connect real host to the simulated network
connect-real-network-napt enable NAPT from simulated network
connect-real-network-port-in setup port forwarding to a simulated machine
connect-real-network-port-out setup port forwarding to real machine
connect-real-network-router connect router between real and simulated network
default-port-forward-target set default port forwarding target
disconnect-real-network disconnect from the real network
disconnect-real-network-port-in remove port forwarding to a simulated machine
disconnect-real-network-port-out remove port forwarding to real machine
list-port-forwarding-setup view the port forwarding setup
network-helper set/show name of host network helper

Registers

% read register by name
<processor>.pregs print cpu registers
<processor>.read-reg read a register
<processor>.register-number get the number of a processor register
<processor>.write-reg write to register
pregs print cpu registers
read-reg read a register
set-pc set the current processor's program counter
write-reg write to register

Reverse Execution

clear-recorder clear recorded events
delete-bookmark delete a time bookmark
list-bookmarks list time bookmarks
reverse run simulation backwards
reverse-step-instruction reverse step one or more instruction
reverse-to set a temporary time breakpoint and run backwards
rexec-limit tune reverse execution performance parameters
set-bookmark set a bookmark at the current point in time
skip-to skip to the specified point in the simulation

Serial

new-serial-link create a new serial link

Simics Search Path

add-directory add a directory to the Simics search path
add-module-directory add a directory to the module search path
clear-directories clear the Simics search path
list-directories list directories in Simics search path
resolve-file resolve a filename

Speed

cpu-switch-time get/set CPU switch time
enable-real-time-mode set real time mode for Simics
istc-enable enable I-STC
v9-sol9-idle-opt enable idle loop optimization

Symbolic Debugging

<context-switcher>.track-bin track first use of a given binary
<context-switcher>.track-pid track the process with a given pid
<context>.finish-function finish the current function
<context>.next-instruction run to the next instruction, skipping subroutine calls
<context>.next-line run to the next source line, skipping subroutine calls
<context>.on switch on context object
<context>.reverse-next-instruction back to the previous instruction, skipping subroutine calls
<context>.reverse-next-line back to the previous source line, skipping subroutine calls
<context>.reverse-step-instruction back to the previous instruction
<context>.reverse-step-line back to the previous source line
<context>.step-instruction run to the next instruction
<context>.step-line run to the next source line
<context>.symtable set the symbol table of a context
<context>.uncall-function go back to when the current function was called
<processor>.down go down N stack frames
<processor>.frame change current stack frame
<processor>.list list source and/or disassemble
<processor>.pos address of line or function
<processor>.psym print value of symbolic expression
<processor>.stack-trace display stack trace
<processor>.symval evaluate symbolic expression
<processor>.up go up N stack frames
<symtable>.abi set ABI to use
<symtable>.list list source and/or disassemble
<symtable>.load-symbols load symbols from file
<symtable>.plain-symbols read raw symbols in nm format
<symtable>.pos address of line or function
<symtable>.source-path set source search path for debug info
<symtable>.whereis find symbol by address
down go down N stack frames
finish-function finish the current function
frame change current stack frame
gdb-remote start gdb-remote
list list source and/or disassemble
new-context create a new context
new-gdb-remote create a gdb session
new-symtable create new symbol table
next-instruction run to the next instruction, skipping subroutine calls
next-line run to the next source line, skipping subroutine calls
pos address of line or function
psym print value of symbolic expression
reverse-next-instruction back to the previous instruction, skipping subroutine calls
reverse-next-line back to the previous source line, skipping subroutine calls
reverse-step-line back to the previous source line
set-context set the current context of a CPU
stack-trace display stack trace
step-line run to the next source line
symval evaluate symbolic expression
uncall-function go back to when the current function was called
up go up N stack frames
whereis find symbol by address

Test

expect fail if not equal

Tracing

<processor>.instruction-fetch-mode set or get current mode for instruction fetching
instruction-fetch-mode set or get current mode for instruction fetching
new-tracer create a new tracer

VIRTUTECH CONFIDENTIAL    Previous - Up - Next