VIRTUTECH CONFIDENTIAL    Previous - Up - Next

4.3   Global Command Descriptions

!
Synopsis
!
Description
Executes the rest of the command line in the system command-line interpreter. For Unix, this is the default shell. For Windows, this is cmd.exe.
Provided By
Simics Core
!=
Synopsis
arg1 != arg2
Description
Returns 1 if arg1 and arg2 are not equal, and 0 if equal.
Provided By
Simics Core
$
Synopsis
$ "name"
Description
Gets the value of a Simics environment variable, like in print $var.
Provided By
Simics Core
%
Synopsis
% "reg-name"
Description
Returns the value of the register reg-name for the current processor. This is a convenient way to use register values in expressions like disassemble (%pc − 4*3) 10.

Use pselect to select the current processor.

Provided By
Simics Core
See Also
read-reg, write-reg, pregs
&
Synopsis
arg1 & arg2
Description
Bitwise AND operation.
Provided By
Simics Core
*
Synopsis
arg1 * arg2
Description
Arithmetic multiplication.
Provided By
Simics Core
+
Synopsis
arg1 + arg2
Description
Arithmetic addition.
Provided By
Simics Core
+=
Synopsis
"name" += value
Description
Add a string or integer to a Simics environment variable, or an integer value to a register.
Provided By
Simics Core
-
Synopsis
arg1 - arg2
Description
Arithmetic subtraction.
Provided By
Simics Core
-=
Synopsis
"name" -= value
Description
Subtract an integer from a Simics environment variable, or from a register.
Provided By
Simics Core
->
Synopsis
"object" -> "attribute" (-r|-w) [value]
Description
Get the value of attribute from object. Only object, string, float and integer attributes can be returned by the command. Other attribute types will be printed, but the command will not return anything.
Provided By
Simics Core
/
Synopsis
arg1 / arg2
Description
Arithmetic division.
Provided By
Simics Core
<
Synopsis
arg1 < arg2
Description
Returns 1 if arg1 is less than arg2, and 0 if not.
Provided By
Simics Core
<<
Synopsis
arg1 << arg2
Description
Bitwise left shift.
Provided By
Simics Core
<=
Synopsis
arg1 <= arg2
Description
Returns 1 if arg1 is less than or equal to arg2, and 0 if not.
Provided By
Simics Core
=
Synopsis
"name" = value
Description
Set a Simics environment variable to an integer or string value. Or assigns a value to a processor register.
Provided By
Simics Core
==
Synopsis
arg1 == arg2
Description
Returns 1 if arg1 and arg2 are equal, and 0 if not.
Provided By
Simics Core
>
Synopsis
arg1 > arg2
Description
Returns 1 if arg1 is greater than arg2, and 0 if not.
Provided By
Simics Core
>=
Synopsis
arg1 >= arg2
Description
Returns 1 if arg1 is greater than or equal to arg2, and 0 if not.
Provided By
Simics Core
>>
Synopsis
arg1 >> arg2
Description
Bitwise right shift.
Provided By
Simics Core
@
Synopsis
@
Description
Evaluates the rest of the command line as a Python statement and print its result.
Provided By
Simics Core
See Also
python, run-python-file
[
Synopsis
"variable" [ idx (-r|-w) value
Description
Provided By
Simics Core
^
Synopsis
arg1 ^ arg2
Description
Bitwise XOR operation.
Provided By
Simics Core
add-directory
Synopsis
add-directory path [-prepend]
Description
Adds a directory to the Simics search path. The Simics search path is a list of directories where Simics searches for additional files when loading a configuration or executing a command like load-file.

The value of path is normally appended at the end of the list. If the -prepend flag is given, the path will be added as first in the list.

Provided By
Simics Core
add-module-directory
Synopsis
add-module-directory path
Description
Adds a directory to the Simics module search path. This path is used to look for additional modules, that can be used to extend the functionality of Simics.
Provided By
Simics Core
and
Synopsis
arg1 and arg2
Description
Returns 1 if both arg1 and arg2 are non-zero, and 0 if not.
Provided By
Simics Core
api-apropos
Synopsis
api-apropos "search-string"
Description
Search the API documentation for the string search-string.
Provided By
Simics Core
See Also
api-help, apropos, help
api-help
Synopsis
api-help "topic"
Description
Prints the declaration of API declarations matching topic.
Provided By
Simics Core
See Also
api-apropos, apropos, help
apropos
Alias
a
Synopsis
apropos [-r] "string"
Description
Use apropos string to list all commands for which the documentation contains the text string. If the -r flag is used, interpret string as a regular expression.
Provided By
Simics Core
See Also
api-apropos, help
break
Alias
b
Synopsis
break address [length] [-r] [-w] [-x]
<breakpoint>.break address [length] [-r] [-w] [-x]
<breakpoint>.tbreak address [length] [-r] [-w] [-x]
Description
Add breakpoint (read, write, or execute) on an object implementing the breakpoint interface. This is typically a memory space object such as physical memory; e.g., phys_mem0.break 0xff3800. Accesses intersecting the given range will trigger the breakpoint. By default the breakpoint will only trigger for instruction execution, but any subset of read, write, and execute accesses can be set to trigger using combinations of -r, -w, and -x.

length is the interval length in bytes (default is 1).

Breakpoints inserted with the tbreak command are automatically disabled when they have triggered.

The default action at a triggered breakpoint is to return to the frontend. This can be changed by using haps. When an execution breakpoint is triggered, Simics will return to the command prompt before the instructions is executed, while instructions triggering read or write breakpoints will complete before control is returned to the command prompt.

To break on a virtual address, use a context object:

primary_context.break 0x1ff00

Several breakpoints can be set on the same address and Simics will break on them in turn. If hap handlers (callback functions) are connected to the breakpoints they will also be executed in turn. Hap handlers are called before the access is performed, allowing the user to read a memory value that may be overwritten by the access. See the Simics Reference Manual for a description of hap handlers.

Each breakpoint is associated with an id (printed when the breakpoint is set or by the list-breakpoints command) which is used for further references to the breakpoint.

For convenience there are also a break command which sets a breakpoint on memory connected to the current frontend CPU (see pselect). Default is to break on virtual address accesses (in the current context). By prefixing the address with p: it is possible to break on physical accesses as well (cf. phys_mem0.break); e.g., break p:0xffc0.

Several attributes can be set for a breakpoint for breaking only when some conditions are true. See the disable, enable, ignore, set-prefix, set-substr and set-pattern commands for more details.

Breakpoints can be removed using delete.

Provided By
Simics Core
See Also
unbreak, delete, enable, ignore, set-prefix, set-substr, set-pattern, list-breakpoints
break-cr
Synopsis
break-cr ("register"|-all|-list)
<processor>.break-cr ("register"|-all|-list)
<processor>.unbreak-cr ("register"|-all|-list)
unbreak-cr ("register"|-all|-list)
Description
Enables and disables breaking simulation on control register updates. When this is enabled, every time the specified control register is updated during simulation a message is printed. The message will name the register being updated, and the new value. The new value will be printed even if it is identical to the previous value.

The reg-name parameter specifies which control register should be traced. The available control registers depends on the simulated target.

Instead of a register name, the -all flag may be given. This will enable or disable tracing of all control register.

Provided By
Simics Core
See Also
trace-cr, <breakpoint>.break
break-exception
Synopsis
break-exception (number|"name"|-all|-list)
unbreak-exception (number|"name"|-all|-list)
Description
Enables and disables breaking simulation on exceptions. When this is enabled, every time the specified exception occurs uring simulation a message is printed.

The exception parameter specifies which exception should be traced. The available exceptions depends on the simulated target.

Instead of an exception, the -all flag may be given. This will enable or disable tracing of all exceptions.

Provided By
Simics Core
See Also
trace-exception, <breakpoint>.break
break-hap
Synopsis
break-hap ("hap"|-all|-list)
unbreak-hap ("hap"|-all|-list)
Description
Enables and disables breaking simulation on haps. When this is enabled, every time the specified hap is triggered a message is printed and simulation is stopped.

The hap parameter specifies the hap.

Instead of a hap, the -all flag may be given. This will enable or disable breaking on all haps.

Provided By
Simics Core
See Also
trace-hap, list-haps
break-io
Synopsis
break-io ("device"|-all|-list)
unbreak-io ("device"|-all|-list)
Description
Enables and disables breaking simulation on device accesses. When this is enabled, every time the specified device is accessed during simulation a message is printed and the simulation stops.

The device parameter specifies which device object should be traced.

Instead of an object name, the -all flag may be given. This will enable or disable breaking on accesses to all device.

Provided By
Simics Core
See Also
trace-io, <breakpoint>.break
break-log
Synopsis
break-log ["substring"] [object] [type]
Description
Break on log message. With no arguments the simulation will stop when the next log message is printed. By specifying object, type, and/or substring it will stop on the next log message matching these conditions. The break is triggered once only, to break again you need to run the command again.
Provided By
Simics Core
cd
Synopsis
cd path
Description
Change working directory of Simics. Works as if you had done 'cd' at the shell. Converts param to host native form first (see native-path).
Provided By
Simics Core
See Also
ls, pwd
clear-directories
Synopsis
clear-directories
Description
Empty the Simics search path.
Provided By
Simics Core
clear-recorder
Synopsis
clear-recorder
Description
Discard recorded input events (e.g. human console input). This command allows an alternate future to take place.
Provided By
rev-execution
close-tun-tap-interface
Synopsis
close-tun-tap-interface ["interface"]
Description
Closes an TUN/TAP interface that has been set persistent. If the interface is currenly is used, it will not be closed at once, only the persistent state will change. Not applicable for for TAP-Win32 interfaces.
Provided By
real-network
command-list
Synopsis
command-list file
Description
Produces a quick reference list of Simics commands in HTML. Note that Simics commands can be added at runtime, and any particular dynamic usage will be different from printed manuals. file is the file to write to.
Provided By
Simics Core
connect-central
Synopsis
connect-central ("server"|obj) [reconnect]
Description
Connect Simics to a Simics Central server.

The server argument specifies the server to connect to. It is either of the form <addr>[:<port>] if a TCP connection should be used, or a file name if a file socket should be used. This is the same as the command line argument -central, but can be executed at any time.

To connect to a server object in the same Simics, use the obj argument instead.

The reconnect argument gives the time between tries to connect to the server if a connection can't be established, or if the connection is lost. A value of zero disables reconnection. The default is to not try to reconnect.

Provided By
central
See Also
new-central-server, <central-client>.disconnect, <central-client>.connect
connect-components
Synopsis
connect-components src-component ["src-connector"] [component] ["dst-connector"] [-f]
Description
Creates a connection between the connectors src-connector and dst-connector of the src-component and dst-component components. If only a single connector pair on the two components have maching types, then the connector arguments to the command can be left out. Similarly it is possible to give a connector name for only one of the components if there is a single matching connector on the other component. The -f flag tells the command to use the first unused connector (in alphabetic order) if several ones match.
Provided By
Simics Core
connect-real-network
Synopsis
connect-real-network ["target-ip"] [ethernet-link] ["service-node-ip"]
Description
Enables port forwarding from the host that Simics is running on, to a simulated machine specified by target-ip, allowing access from real hosts to the simulated one. Ports are opened on the host for a number of commonly used protocol (such as ftp and telnet), additional ports can be configured using the connect-real-network-port-in command. Port forwarding can be enabled for several simulated machines at the same time. This command also enables NAPT for accesses that are initiated from the simulated machine. If several Ethernet links exists, the one that the simulated machine is connected to must be specified. If no Ethernet link exists, one will be created and all Ethernet devices are connected to it. A service-node will also be added to the link if there isn't one connected already. If a service-node is added it will either get the IP address service-node-ip if it was specified, or the IP of the target with the lowest byte set to 1. If a default port-forwarding target has been set using the default-port-forward-target command, then the target-ip argument can be left out.
Provided By
service-node
See Also
default-port-forward-target, connect-real-network-napt, connect-real-network-port-in, connect-real-network-port-out, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
connect-real-network-bridge
Synopsis
connect-real-network-bridge ["interface"] ["host-access"] [-no-mac-xlate] [-persistent] [-propagate-link-status]
<ethernet-link>.connect-real-network-bridge ["interface"] ["host-access"] [-no-mac-xlate] [-persistent] [-propagate-link-status]
Description
Creates an Ethernet bridge between a simulated Ethernet link and a real network through an Ethernet interface of the simulation host.

The optional interface argument specifies the Ethernet or TAP interface of the host to use.

By default a TAP interface is used, but if the host-access argument is raw, raw access to an Ethernet interface is used.

MAC address translation can be disabled with the -no-mac-xlate flag.

The -persistent is for backward compatibility and should not be used.

If -propagate-link-status is specified, link status changes on the host interface will be propagated to all devices on the link that implements the link-status interface. For TUN/TAP, only 'up' and 'down' status will be propagated (and not 'unconnected'). Link status propagation is only supported on Linux.

See the Connecting to a Real Network chapter of the Simics User Guide for more information about how to connect to a real network.

Provided By
ethernet-link
See Also
connect-real-network, <ethernet-link>.connect-real-network-bridge, connect-real-network-host, connect-real-network-router
connect-real-network-host
Synopsis
connect-real-network-host ["interface"] [-persistent]
<ethernet-link>.connect-real-network-host ["interface"] [-persistent]
Description
Connects a TAP interface of the simulation host to a simulated Ethernet link.

The optional interface argument specifies the TAP interface of the host to use.

The -persistent is for backward compatibility and should not be used.

See the Connecting to a Real Network chapter of the Simics User Guide for more information about how to connect to a real network.

This command is currently not supported on Solaris hosts.

Provided By
ethernet-link
See Also
connect-real-network, <ethernet-link>.connect-real-network-host, connect-real-network-bridge, connect-real-network-router
connect-real-network-napt
Synopsis
connect-real-network-napt ethernet-link
<ethernet-link>.connect-real-network-napt
Description
Enables machines on the simulated network to initiate accesses to real hosts without the need to configure the simulated machine with a real IP address. NAPT (Network Address Port Translation) uses the IP address and a port number of the host that Simics is running on to perform the access. Replies are then translated back to match the request from the simulated machine. This command also enables NAPT for accesses that are initiated from the simulated machine.
Provided By
service-node
See Also
connect-real-network, connect-real-network-port-in, connect-real-network-port-out, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
connect-real-network-port-in
Synopsis
connect-real-network-port-in (target-port|"service") ethernet-link [host-port] ["target-ip"] [-tcp] [-udp] [-f]
disconnect-real-network-port-in (target-port|"service") ethernet-link ["target-ip"] [-tcp] [-udp]
Description
Enables or disables port forwarding from the host that Simics is running on, to a simulated machine, specified by target-ip. The externally visible port host-port on the host is mapped to the port target-port on the simulated machine. For commonly used services the string argument service can be used instead of a port number. If several Ethernet links exists, the one that the simulated machine is connected to must be specified.

The flags -tcp and -udp can be used to specify the protocol to forward. The default is to forward only the usual protocol for named services and both tcp and udp for numerically specified ports.

The flag -f can be used to cause the command to fail if the suggested host port could not be allocated, without the flag the command will assign the first availble port starting from the specified host port and upwards.

The host-port given is only a hint, and the actual port used may be a different one. The command output shows the actual port used, and it can also be determined by inspecting the connections attribute in the appropriate port forwarding object.

Provided By
service-node
See Also
connect-real-network, connect-real-network-port-out, connect-real-network-napt, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
connect-real-network-port-out
Synopsis
connect-real-network-port-out service-node-port ethernet-link "target-ip" target-port [-tcp] [-udp]
disconnect-real-network-port-out service-node-port ethernet-link "target-ip" target-port [-tcp] [-udp]
Description
Enables port forwarding to a machine on the real network. Traffic targeting port service-node-port on the service node connected to ethernet-link will be forwarded to port target-port on target-ip.

Both tcp and udp will be forwarded unless one of the -tcp or -udp flags are given in which case only that protocol will be forwarded.

Provided By
service-node
See Also
connect-real-network, connect-real-network-port-in, connect-real-network-napt, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
connect-real-network-router
Synopsis
connect-real-network-router "ip" ["netmask"] ["gateway"] ["interface"]
<ethernet-link>.connect-real-network-router "ip" ["netmask"] ["gateway"] ["interface"]
Description
Creates a routed connection between a simulated Ethernet link and a real network through an Ethernet interface of the simulation host.

The optional interface argument specifies the Ethernet interface of the host to use.

The ip and netmask arguments specify the IP address and netmask that the router should use on the simulated Ethernet link.

The gateway argument specifies the gateway on the simulated Ethernet link that router should use for packets from the real network that are not in the router's subnet.

See the Connecting to a Real Network chapter of the Simics User Guide for more information about how to connect to a real network.

Provided By
ethernet-link
See Also
connect-real-network, <ethernet-link>.connect-real-network-router, connect-real-network-host, connect-real-network-bridge
copyright
Synopsis
copyright
Description
Prints the complete copyright information that applies to this copy of Simics.
Provided By
Simics Core
cpu-switch-time
Synopsis
cpu-switch-time [(cycles|seconds)]
Description
Change the time, in cycles or seconds, between CPU switches. Simics will simulate each processor for a specified number of cycles before switching to the next one. Specifying cycles (which is default) refers to the number of cycles on the first CPU in Simics. The following CPUs cycle switch times are calulated from their CPU frequencies. When issued with no argument, the current switch time is reported.
Provided By
Simics Core
create-agp-voodoo3
Synopsis
create-agp-voodoo3 ["name"]
Description
Creates a non-instantiated component of the class "agp-voodoo3". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-alpha-lx164-system
Synopsis
create-alpha-lx164-system ["name"] cpu_frequency memory_megs "rtc_time" ["bios"]
Description
Creates a non-instantiated component of the class "alpha-lx164-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
alpha-components
create-and-connect-ddr-memory
Synopsis
create-and-connect-ddr-memory "system" memory_megs "organization" [ranks_per_module] [min_module_size] [max_module_size] [ecc]
Description
Create and connect DDR memory modules to the system. The memory_megs attribute defines the total module memory size in MB. It is possible to create different kind of module combinations with the organization parameter. The organization is a string. Each character in the string represents a module. The first character is module 0, second character is module 1, etc. Supported characters are a-z and A-Z. Two modules can have the same character. An equal upper case character means that the modules must be of identical size. An equal lower case character means that the modules must be identical or unpopulated. The character '-' indicates that the slot should not contain any modules.

Example 1: AB Create one or two modules with any size (all slots need not be populated).

Example 2: AA Create two modules with identical size.

Example 3: aa Create one module or two modules with identical size.

Optional arguments are ranks_per_module, min_module_size, max_module_size, and ecc.

Provided By
memory-components
create-arm-sa1110-system
Synopsis
create-arm-sa1110-system ["name"] cpu_frequency [memory_megs]
Description
Creates a non-instantiated component of the class "arm-sa1110-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
arm-sa1110-components
create-ddr-memory-module
Synopsis
create-ddr-memory-module ["name"] [rows] [columns] [ranks] [module_data_width] [primary_width] [ecc_width] [banks] [rank_density] ["module_type"] [cas_latency] ["speed"]
Description
Creates a non-instantiated component of the class "ddr-memory-module". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
memory-components
create-ddr2-memory-module
Synopsis
create-ddr2-memory-module ["name"] [rows] [columns] [ranks] [module_data_width] [primary_width] [ecc_width] [banks] [rank_density] ["module_type"] [cas_latency]
Description
Creates a non-instantiated component of the class "ddr2-memory-module". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
memory-components
create-dummy-component
Synopsis
create-dummy-component ["name"]
Description
Creates a non-instantiated component of the class "dummy-component". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-ebony-board
Synopsis
create-ebony-board ["name"] "rtc_time" cpu_frequency "mac_address0" "mac_address1"
Description
Creates a non-instantiated component of the class "ebony-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ppc440gp-components
create-enchilada-system
Synopsis
create-enchilada-system ["name"] cpu_frequency hostid "mac_address" "rtc_time" num_cpus
Description
Creates a non-instantiated component of the class "enchilada-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
fiesta-components
create-i386-cpu
Synopsis
create-i386-cpu ["name"] cpu_frequency [cpi]
Description
Creates a non-instantiated component of the class "i386-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-i486dx2-cpu
Synopsis
create-i486dx2-cpu ["name"] cpu_frequency [cpi]
Description
Creates a non-instantiated component of the class "i486dx2-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-i486sx-cpu
Synopsis
create-i486sx-cpu ["name"] cpu_frequency [cpi]
Description
Creates a non-instantiated component of the class "i486sx-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-ia64-460gx-system
Synopsis
create-ia64-460gx-system ["name"] memory_megs "rtc_time"
Description
Creates a non-instantiated component of the class "ia64-460gx-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ia64-components
create-isa-lance
Synopsis
create-isa-lance ["name"] "mac_address" [irq_level] [base_port]
Description
Creates a non-instantiated component of the class "isa-lance". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-isa-vga
Synopsis
create-isa-vga ["name"] ["bios"]
Description
Creates a non-instantiated component of the class "isa-vga". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-itanium-cpu
Synopsis
create-itanium-cpu ["name"] cpu_frequency
Description
Creates a non-instantiated component of the class "itanium-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ia64-components
create-legacy-pc-devices
Synopsis
create-legacy-pc-devices ["name"]
Description
Creates a non-instantiated component of the class "legacy-pc-devices". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-leon2-simple
Synopsis
create-leon2-simple ["name"] cpu_frequency prom_size has_sram sram_size sdram_size num_windows has_v8e_mac has_v8_mul has_v8_div
Description
Creates a non-instantiated component of the class "leon2-simple". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
leon2-components
create-malta-system
Synopsis
create-malta-system ["name"] cpu_frequency "cpu_class" "rtc_time"
Description
Creates a non-instantiated component of the class "malta-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
malta-components
create-niagara-simple-system
Synopsis
create-niagara-simple-system ["name"] cpu_frequency num_cores strands_per_core "rtc_time"
Description
Creates a non-instantiated component of the class "niagara-simple-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
niagara-simple-components
create-north-bridge-443bx
Synopsis
create-north-bridge-443bx ["name"]
Description
Creates a non-instantiated component of the class "north-bridge-443bx". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-north-bridge-443bx-agp
Synopsis
create-north-bridge-443bx-agp ["name"]
Description
Creates a non-instantiated component of the class "north-bridge-443bx-agp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-north-bridge-875p
Synopsis
create-north-bridge-875p ["name"]
Description
Creates a non-instantiated component of the class "north-bridge-875p". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-north-bridge-e7520
Synopsis
create-north-bridge-e7520 ["name"]
Description
Creates a non-instantiated component of the class "north-bridge-e7520". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-north-bridge-k8
Synopsis
create-north-bridge-k8 ["name"]
Description
Creates a non-instantiated component of the class "north-bridge-k8". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-opteron-cpu
Synopsis
create-opteron-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "opteron-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pc-dual-serial-ports
Synopsis
create-pc-dual-serial-ports ["name"]
Description
Creates a non-instantiated component of the class "pc-dual-serial-ports". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-pc-floppy-controller
Synopsis
create-pc-floppy-controller ["name"]
Description
Creates a non-instantiated component of the class "pc-floppy-controller". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-pc-quad-serial-ports
Synopsis
create-pc-quad-serial-ports ["name"]
Description
Creates a non-instantiated component of the class "pc-quad-serial-ports". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-pc-single-parallel-port
Synopsis
create-pc-single-parallel-port ["name"]
Description
Creates a non-instantiated component of the class "pc-single-parallel-port". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-pci-am79c973
Synopsis
create-pci-am79c973 ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-am79c973". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-backplane
Synopsis
create-pci-backplane ["name"]
Description
Creates a non-instantiated component of the class "pci-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-bcm5703c
Synopsis
create-pci-bcm5703c ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-bcm5703c". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-bcm5704c
Synopsis
create-pci-bcm5704c ["name"] "mac_address0" "mac_address1" ["bios"]
Description
Creates a non-instantiated component of the class "pci-bcm5704c". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-dec21041
Synopsis
create-pci-dec21041 ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-dec21041". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-dec21140a
Synopsis
create-pci-dec21140a ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-dec21140a". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-dec21140a-dml
Synopsis
create-pci-dec21140a-dml ["name"] "mac_address"
Description
Creates a non-instantiated component of the class "pci-dec21140a-dml". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-dec21143
Synopsis
create-pci-dec21143 ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-dec21143". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-i21152
Synopsis
create-pci-i21152 ["name"]
Description
Creates a non-instantiated component of the class "pci-i21152". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-i82543gc
Synopsis
create-pci-i82543gc ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-i82543gc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-i82546bg
Synopsis
create-pci-i82546bg ["name"] "mac_address" ["bios"]
Description
Creates a non-instantiated component of the class "pci-i82546bg". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-isp1040
Synopsis
create-pci-isp1040 ["name"] [scsi_id] ["bios"]
Description
Creates a non-instantiated component of the class "pci-isp1040". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-isp2200
Synopsis
create-pci-isp2200 ["name"] loop_id ["bios"]
Description
Creates a non-instantiated component of the class "pci-isp2200". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-pd6729
Synopsis
create-pci-pd6729 ["name"]
Description
Creates a non-instantiated component of the class "pci-pd6729". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-pmc1553-bc
Synopsis
create-pci-pmc1553-bc ["name"]
Description
Creates a non-instantiated component of the class "pci-pmc1553-bc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-rage-pm-mobility-pci
Synopsis
create-pci-rage-pm-mobility-pci ["name"]
Description
Creates a non-instantiated component of the class "pci-rage-pm-mobility-pci". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-ragexl
Synopsis
create-pci-ragexl ["name"]
Description
Creates a non-instantiated component of the class "pci-ragexl". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-sil680a
Synopsis
create-pci-sil680a ["name"]
Description
Creates a non-instantiated component of the class "pci-sil680a". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-sym53c810
Synopsis
create-pci-sym53c810 ["name"] ["bios"]
Description
Creates a non-instantiated component of the class "pci-sym53c810". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-sym53c875
Synopsis
create-pci-sym53c875 ["name"] ["bios"]
Description
Creates a non-instantiated component of the class "pci-sym53c875". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-sym53c876
Synopsis
create-pci-sym53c876 ["name"]
Description
Creates a non-instantiated component of the class "pci-sym53c876". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-vga
Synopsis
create-pci-vga ["name"] ["bios"]
Description
Creates a non-instantiated component of the class "pci-vga". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pci-voodoo3
Synopsis
create-pci-voodoo3 ["name"]
Description
Creates a non-instantiated component of the class "pci-voodoo3". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pcie-pex8524
Synopsis
create-pcie-pex8524 ["name"] ["ports"] [up_port_number] [nt_port_number]
Description
Creates a non-instantiated component of the class "pcie-pex8524". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-pentium-4-cpu
Synopsis
create-pentium-4-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-4-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-4e-2ht-cpu
Synopsis
create-pentium-4e-2ht-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-4e-2ht-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-4e-4ht-cpu
Synopsis
create-pentium-4e-4ht-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-4e-4ht-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-4e-cpu
Synopsis
create-pentium-4e-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-4e-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-cpu
Synopsis
create-pentium-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-ii-cpu
Synopsis
create-pentium-ii-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-ii-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-iii-cpu
Synopsis
create-pentium-iii-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-iii-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-m-cpu
Synopsis
create-pentium-m-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-m-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-mmx-cpu
Synopsis
create-pentium-mmx-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-mmx-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-pentium-pro-cpu
Synopsis
create-pentium-pro-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "pentium-pro-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-phy-mii-transceiver
Synopsis
create-phy-mii-transceiver ["name"] [phy_id] [mii_address]
Description
Creates a non-instantiated component of the class "phy-mii-transceiver". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
phy-components
create-pmppc-board
Synopsis
create-pmppc-board ["name"] "cpu_class" cpu_frequency timebase_frequency "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "pmppc-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pmppc-components
create-ppc-simple
Synopsis
create-ppc-simple ["name"] "cpu_class" cpu_frequency memory_megs
Description
Creates a non-instantiated component of the class "ppc-simple". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ppc-simple-components
create-ppc970-simple
Synopsis
create-ppc970-simple ["name"] cpu_frequency memory_megs [map_offset] ["time_of_day"]
Description
Creates a non-instantiated component of the class "ppc970-simple". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ppc970fx-components
create-ps2-keyboard-mouse
Synopsis
create-ps2-keyboard-mouse ["name"]
Description
Creates a non-instantiated component of the class "ps2-keyboard-mouse". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-sample-gcache
Synopsis
create-sample-gcache ["name"]
Description
Creates a non-instantiated component of the class "sample-gcache". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
create-sample-ma-model
Synopsis
create-sample-ma-model ["name"]
Description
Creates a non-instantiated component of the class "sample-ma-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
create-sample-ooo-model
Synopsis
create-sample-ooo-model ["name"]
Description
Creates a non-instantiated component of the class "sample-ooo-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
create-sample-x86-ma-model
Synopsis
create-sample-x86-ma-model ["name"]
Description
Creates a non-instantiated component of the class "sample-x86-ma-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
create-sdram-memory-module
Synopsis
create-sdram-memory-module ["name"] [rows] [columns] [ranks] [module_data_width] [primary_width] [ecc_width] [banks] [rank_density] ["module_type"] [cas_latency]
Description
Creates a non-instantiated component of the class "sdram-memory-module". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
memory-components
create-serengeti-3800-chassis
Synopsis
create-serengeti-3800-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "serengeti-3800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-4800-chassis
Synopsis
create-serengeti-4800-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "serengeti-4800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-4810-chassis
Synopsis
create-serengeti-4810-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "serengeti-4810-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-6800-chassis
Synopsis
create-serengeti-6800-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "serengeti-6800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-cluster-chassis
Synopsis
create-serengeti-cluster-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "serengeti-cluster-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-cpci4-board
Synopsis
create-serengeti-cpci4-board ["name"]
Description
Creates a non-instantiated component of the class "serengeti-cpci4-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-pci8-board
Synopsis
create-serengeti-pci8-board ["name"]
Description
Creates a non-instantiated component of the class "serengeti-pci8-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-sp-cpci6-board
Synopsis
create-serengeti-sp-cpci6-board ["name"]
Description
Creates a non-instantiated component of the class "serengeti-sp-cpci6-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-us-iii-cpu-board
Synopsis
create-serengeti-us-iii-cpu-board ["name"] num_cpus memory_megs cpu_frequency
Description
Creates a non-instantiated component of the class "serengeti-us-iii-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-us-iii-plus-cpu-board
Synopsis
create-serengeti-us-iii-plus-cpu-board ["name"] num_cpus memory_megs cpu_frequency
Description
Creates a non-instantiated component of the class "serengeti-us-iii-plus-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-us-iv-cpu-board
Synopsis
create-serengeti-us-iv-cpu-board ["name"] num_cpus memory_megs cpu_frequency
Description
Creates a non-instantiated component of the class "serengeti-us-iv-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-serengeti-us-iv-plus-cpu-board
Synopsis
create-serengeti-us-iv-plus-cpu-board ["name"] num_cpus memory_megs cpu_frequency
Description
Creates a non-instantiated component of the class "serengeti-us-iv-plus-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-simple-fc-disk
Synopsis
create-simple-fc-disk ["name"] size ["file"] loop_id node_name port_name
Description
Creates a non-instantiated component of the class "simple-fc-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-sio-lpc47m172
Synopsis
create-sio-lpc47m172 ["name"] ld_num
Description
Creates a non-instantiated component of the class "sio-lpc47m172". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-sio-w83627hf
Synopsis
create-sio-w83627hf ["name"]
Description
Creates a non-instantiated component of the class "sio-w83627hf". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-south-bridge-6300esb
Synopsis
create-south-bridge-6300esb ["name"] "bios" [flash_size]
Description
Creates a non-instantiated component of the class "south-bridge-6300esb". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-south-bridge-amd8111
Synopsis
create-south-bridge-amd8111 ["name"]
Description
Creates a non-instantiated component of the class "south-bridge-amd8111". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-south-bridge-md1535d
Synopsis
create-south-bridge-md1535d ["name"]
Description
Creates a non-instantiated component of the class "south-bridge-md1535d". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-south-bridge-piix4
Synopsis
create-south-bridge-piix4 ["name"]
Description
Creates a non-instantiated component of the class "south-bridge-piix4". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
create-south-bridge-saturn
Synopsis
create-south-bridge-saturn ["name"]
Description
Creates a non-instantiated component of the class "south-bridge-saturn". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
alpha-components
create-south-bridge-sun-md1535d
Synopsis
create-south-bridge-sun-md1535d ["name"]
Description
Creates a non-instantiated component of the class "south-bridge-sun-md1535d". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
fiesta-components
create-std-etg
Synopsis
create-std-etg ["name"] "mac_address" "ip" "netmask" "dst_ip" "gateway_ip" pps packet_size
Description
Creates a non-instantiated component of the class "std-etg". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-ethernet-link
Synopsis
create-std-ethernet-link ["name"] ["link_name"] [frame_echo]
Description
Creates a non-instantiated component of the class "std-ethernet-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-graphics-console
Synopsis
create-std-graphics-console ["name"] [window]
Description
Creates a non-instantiated component of the class "std-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-host-serial-console
Synopsis
create-std-host-serial-console ["name"]
Description
Creates a non-instantiated component of the class "std-host-serial-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-ide-cdrom
Synopsis
create-std-ide-cdrom ["name"]
Description
Creates a non-instantiated component of the class "std-ide-cdrom". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-ide-disk
Synopsis
create-std-ide-disk ["name"] size ["file"]
Description
Creates a non-instantiated component of the class "std-ide-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-ms1553-link
Synopsis
create-std-ms1553-link ["name"]
Description
Creates a non-instantiated component of the class "std-ms1553-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-pcmcia-flash-disk
Synopsis
create-std-pcmcia-flash-disk ["name"] size ["file"]
Description
Creates a non-instantiated component of the class "std-pcmcia-flash-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-scsi-bus
Synopsis
create-std-scsi-bus ["name"]
Description
Creates a non-instantiated component of the class "std-scsi-bus". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-scsi-cdrom
Synopsis
create-std-scsi-cdrom ["name"] scsi_id
Description
Creates a non-instantiated component of the class "std-scsi-cdrom". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-scsi-disk
Synopsis
create-std-scsi-disk ["name"] scsi_id size ["file"]
Description
Creates a non-instantiated component of the class "std-scsi-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-serial-link
Synopsis
create-std-serial-link ["name"]
Description
Creates a non-instantiated component of the class "std-serial-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-server-console
Synopsis
create-std-server-console ["name"] telnet_port
Description
Creates a non-instantiated component of the class "std-server-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-service-node
Synopsis
create-std-service-node ["name"]
Description
Creates a non-instantiated component of the class "std-service-node". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-super-io
Synopsis
create-std-super-io ["name"] [add_par_port]
Description
Creates a non-instantiated component of the class "std-super-io". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
isa-components
create-std-text-console
Synopsis
create-std-text-console ["name"] ["title"] ["bg_color"] ["fg_color"] ["x11_font"] ["win32_font"] [width] [height]
Description
Creates a non-instantiated component of the class "std-text-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-std-text-graphics-console
Synopsis
create-std-text-graphics-console ["name"]
Description
Creates a non-instantiated component of the class "std-text-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
create-sun-cpci-hme-isp
Synopsis
create-sun-cpci-hme-isp ["name"] "mac_address" [scsi_id]
Description
Creates a non-instantiated component of the class "sun-cpci-hme-isp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-sun-cpci-isp-isp
Synopsis
create-sun-cpci-isp-isp ["name"] [scsi_id0] [scsi_id1]
Description
Creates a non-instantiated component of the class "sun-cpci-isp-isp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-sun-cpci-qlc-qlc
Synopsis
create-sun-cpci-qlc-qlc ["name"] loop_id0 loop_id1
Description
Creates a non-instantiated component of the class "sun-cpci-qlc-qlc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
create-sun-pci-ce
Synopsis
create-sun-pci-ce ["name"] "mac_address"
Description
Creates a non-instantiated component of the class "sun-pci-ce". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-pci-hme
Synopsis
create-sun-pci-hme ["name"] "mac_address"
Description
Creates a non-instantiated component of the class "sun-pci-hme". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-pci-hme-isp
Synopsis
create-sun-pci-hme-isp ["name"] "mac_address" [scsi_id]
Description
Creates a non-instantiated component of the class "sun-pci-hme-isp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-pci-pgx64
Synopsis
create-sun-pci-pgx64 ["name"]
Description
Creates a non-instantiated component of the class "sun-pci-pgx64". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-pci-qlc
Synopsis
create-sun-pci-qlc ["name"] loop_id
Description
Creates a non-instantiated component of the class "sun-pci-qlc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-pci-qlc-qlc
Synopsis
create-sun-pci-qlc-qlc ["name"] loop_id0 loop_id1
Description
Creates a non-instantiated component of the class "sun-pci-qlc-qlc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-sbus-fas-hme
Synopsis
create-sun-sbus-fas-hme ["name"] "mac_address" [scsi_id]
Description
Creates a non-instantiated component of the class "sun-sbus-fas-hme". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-sun-type5-keyboard
Synopsis
create-sun-type5-keyboard ["name"]
Description
Creates a non-instantiated component of the class "sun-type5-keyboard". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sun-type5-mouse
Synopsis
create-sun-type5-mouse ["name"]
Description
Creates a non-instantiated component of the class "sun-type5-mouse". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
create-sunfire-3500-backplane
Synopsis
create-sunfire-3500-backplane ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "sunfire-3500-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-sunfire-4500-backplane
Synopsis
create-sunfire-4500-backplane ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "sunfire-4500-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-sunfire-6500-backplane
Synopsis
create-sunfire-6500-backplane ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "sunfire-6500-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-sunfire-cpu-board
Synopsis
create-sunfire-cpu-board ["name"] num_cpus memory_megs
Description
Creates a non-instantiated component of the class "sunfire-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-sunfire-pci-board
Synopsis
create-sunfire-pci-board ["name"] "mac_address" [scsi_id]
Description
Creates a non-instantiated component of the class "sunfire-pci-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-sunfire-sbus-board
Synopsis
create-sunfire-sbus-board ["name"] "mac_address" [scsi_id]
Description
Creates a non-instantiated component of the class "sunfire-sbus-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sunfire-components
create-taco-system
Synopsis
create-taco-system ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Description
Creates a non-instantiated component of the class "taco-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
fiesta-components
create-telos-mote
Synopsis
create-telos-mote ["name"] cpu_frequency location_x location_y location_z
Description
Creates a non-instantiated component of the class "telos-mote". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
telos-mote-components
create-x86-apic-bus-system
Synopsis
create-x86-apic-bus-system ["name"] memory_megs "rtc_time" [break_on_reboot]
Description
Creates a non-instantiated component of the class "x86-apic-bus-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-x86-apic-system
Synopsis
create-x86-apic-system ["name"] memory_megs "rtc_time" [break_on_reboot] ["bios"] [acpi]
Description
Creates a non-instantiated component of the class "x86-apic-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-x86-e7520-system
Synopsis
create-x86-e7520-system ["name"] memory_megs "rtc_time" [break_on_reboot] ["bios_name"]
Description
Creates a non-instantiated component of the class "x86-e7520-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-x86-hammer-cpu
Synopsis
create-x86-hammer-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "x86-hammer-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-x86-separate-mem-io-system
Synopsis
create-x86-separate-mem-io-system ["name"] memory_megs "rtc_time" [break_on_reboot] ["bios"]
Description
Creates a non-instantiated component of the class "x86-separate-mem-io-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-x86-system
Synopsis
create-x86-system ["name"] memory_megs "rtc_time" [break_on_reboot] ["bios"]
Description
Creates a non-instantiated component of the class "x86-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
create-xeon-prestonia-cpu
Synopsis
create-xeon-prestonia-cpu ["name"] cpu_frequency [cpi] [apic_frequency]
Description
Creates a non-instantiated component of the class "xeon-prestonia-cpu". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
x86-components
current-processor
Synopsis
current-processor
Description
Returns the name of the currently executing processor.
Provided By
Simics Core
cycle-break
Alias
cb
Synopsis
cycle-break [cpu-name] cycles
<processor>.cycle-break cycles
Description
Sets a breakpoint so that the CPU will stop after running cycles number of cycles from the time the command was issued. If the CPU is not specified the selected frontend processor will be used (see pselect).

To list all breakpoints set use the command list-breakpoints.

Provided By
Simics Core
See Also
cycle-break-absolute, step-break, step-break-absolute, list-breakpoints
cycle-break-absolute
Alias
cba
Synopsis
cycle-break-absolute [cpu-name] cycles
<processor>.cycle-break-absolute cycles
Description
Set a breakpoint so that the selected CPU will stop after its cycle counter has reached the cycles value. If the CPU is not specified the selected frontend processor will be used (see pselect).

To list all breakpoints set use the command list-breakpoints.

Provided By
Simics Core
See Also
cycle-break, step-break, step-break-absolute, list-breakpoints
date
Synopsis
date
Description
Prints the current date and time, in the form Fri Nov 2 12:00:36 2001.
Provided By
Simics Core
default-port-forward-target
Synopsis
default-port-forward-target ["target-ip"]
Description
Sets the IP address of a simulated machine that will be used by the connect-real-network command if none is given as argument. This is useful in single machine configurations where the same IP is used all the time.
Provided By
service-node
See Also
connect-real-network, connect-real-network-port-in
defined
Synopsis
defined "variable"
Description
Returns 1 if variable is a defined CLI variable, and 0 if not.
Provided By
Simics Core
delete
Synopsis
delete (-all|id)
Description
Removes a breakpoint. id is the id of the breakpoint to delete. Use list-breakpoints to list all breakpoints' id. If the flag -all is given, all breakpoints will be deleted.
Provided By
Simics Core
See Also
<breakpoint>.break, enable, ignore, set-prefix, set-substr, set-pattern, list-breakpoints
delete-bookmark
Alias
db
Synopsis
delete-bookmark ("bookmark"|-all)
Description
Deletes a time bookmark. Deleting all time bookmarks can improve forward simulation performance.

Reverse operations are possible in the region following the first (i.e. oldest) time bookmark.

Provided By
rev-execution
See Also
set-bookmark, list-bookmarks, reverse
devs
Synopsis
devs ["object-name"]
Description
Print a list of all devices in Simics, with information about how many times each device has been accessed, and where it is mapped. The mappings are presented as start and end offsets within a named memory space. The function number associated with each different mapping for a device is also printed.
Provided By
Simics Core
digit-grouping
Synopsis
digit-grouping base [digits]
Description
Changes or displays how numbers are formatted for a given radix. This will separate groups of digits digits by an underscore when they are formatted for output. Separate grouping is maintained for each radix. If digits is zero, no separators are printed for that radix.
Provided By
Simics Core
See Also
output-radix, print
dirs
Synopsis
dirs
Description
Shows the contents of the directory stack.
Provided By
Simics Core
See Also
pushd, popd
disable
Synopsis
disable (-all|id)
enable (-all|id)
Description
Enable/disable instruction breakpoint. id is id number of the breakpoint to enable/disable. Use list-breakpoints to list breakpoint id:s. If '-all' is given all breakpoints will be enabled/disabled. Simics will not stop on a disabled breakpoint, however Simics will still count it.
Provided By
Simics Core
See Also
<breakpoint>.break, delete, ignore, list-breakpoints
disable-real-time-mode
Synopsis
disable-real-time-mode
enable-real-time-mode [speed] [check_interval]
Description
In some cases Simics might run faster (in real-time) than the machine it simulates; this can happen if the OS is in a tight idle loop or an instruction halts execution waiting for an interrupt. Running faster than the simulated machine can cause problems for interactive programs which might time-out faster than what the user can handle.

With the enable-real-time-mode command Simics will periodically check its actual running speed and sleep for a while if it is too high. This also reduces Simics CPU usage. speed specifies the percentage (as an integer) of the how fast the Simics target machine is allowed to run compared to the host machine; default is 100%. check_interval specifies how often the measurement should take place in milliseconds of the simulator time; default is 1000.

The disable-real-time-mode will deactivate any real-time behavior and Simics will run as fast as possible again.

Provided By
Simics Core
disassemble
Alias
da
Synopsis
disassemble [cpu-name] [address] [count]
<processor>.disassemble [address] [count]
Description
Disassembles count instructions starting at address for processor cpu-name. If the processor is not given the current frontend processor will be used. The method variant can also be used to select a processor; e.g., cpu0.disassemble.

On some architectures, address must be word aligned. A physical address is given by prefixing the address with p: (e.g., p:0xf000). With no prefix, a virtual address will be assumed. If the address is omitted the current program counter will be used. count defaults to 1 instruction.

Global disassembly settings, such as whether to print the raw opcodes, can be set by the disassemble-settings command.

This command will also include various profiling statistics for the address of each instruction, one column for each profiler view listed in the processor attribute aprof-views. For descriptions of the columns, use the <processor>.aprof-views command.

Provided By
Simics Core
See Also
x, disassemble-settings, <processor>.aprof-views
disassemble-settings
Synopsis
disassemble-settings ["opcode"] ["physaddr"] ["partial-opcode"]
Description
Change disassemble output settings. Each of these settings can be set to on or off.

opcode indicates whether to print the raw bytes of the instruction in addition to the disassembly. If partial-opcode is set, and the opcode encodes more than one instruction, the opcode bytes will be divided among the instructions so that the entire opcode has been printed exactly once when all the instructions have been disassembled. If partial-opcode is not set, the entire opcode will be printed for every instruction. (The only Simics target with multiple instructions per opcode is ia64.)

physaddr indicates whether to compute and display the physical address if the virtual address was specified (if the physical address was specified, the virtual address is never printed).

Without arguments, the current settings will be shown.

Provided By
Simics Core
See Also
disassemble
disconnect-real-network
Synopsis
disconnect-real-network
<ethernet-link>.disconnect-real-network
Description
Closes all connections to real networks except port forwarding and NAPT.
Provided By
ethernet-link
See Also
<ethernet-link>.disconnect-real-network, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
disconnect-real-network-port-in
Synopsis
disconnect-real-network-port-in (target-port|"service") ethernet-link ["target-ip"] [-tcp] [-udp]
connect-real-network-port-in (target-port|"service") ethernet-link [host-port] ["target-ip"] [-tcp] [-udp] [-f]
Description
Enables or disables port forwarding from the host that Simics is running on, to a simulated machine, specified by target-ip. The externally visible port host-port on the host is mapped to the port target-port on the simulated machine. For commonly used services the string argument service can be used instead of a port number. If several Ethernet links exists, the one that the simulated machine is connected to must be specified.

The flags -tcp and -udp can be used to specify the protocol to forward. The default is to forward only the usual protocol for named services and both tcp and udp for numerically specified ports.

The flag -f can be used to cause the command to fail if the suggested host port could not be allocated, without the flag the command will assign the first availble port starting from the specified host port and upwards.

The host-port given is only a hint, and the actual port used may be a different one. The command output shows the actual port used, and it can also be determined by inspecting the connections attribute in the appropriate port forwarding object.

Provided By
service-node
See Also
connect-real-network, connect-real-network-port-out, connect-real-network-napt, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
disconnect-real-network-port-out
Synopsis
disconnect-real-network-port-out service-node-port ethernet-link "target-ip" target-port [-tcp] [-udp]
connect-real-network-port-out service-node-port ethernet-link "target-ip" target-port [-tcp] [-udp]
Description
Enables port forwarding to a machine on the real network. Traffic targeting port service-node-port on the service node connected to ethernet-link will be forwarded to port target-port on target-ip.

Both tcp and udp will be forwarded unless one of the -tcp or -udp flags are given in which case only that protocol will be forwarded.

Provided By
service-node
See Also
connect-real-network, connect-real-network-port-in, connect-real-network-napt, connect-real-network-host, connect-real-network-bridge, connect-real-network-router
display
Synopsis
display ["expression"] [-l] [-p] [-t]
Description
Install a Python expression, or a frontend statement that will be printed when Simics returns to the prompt. The -p flag is used to indicate that the string argument is in Python. To list all installed display expressions, the -l argument should be used. The expressions are only evaluated and printed if the simulation has run any instructions since last time, but a re-evaluation can be forced by calling display with no arguments. The -t argument makes the output be tagged in a way that makes it possible to capture the output by external means.
Provided By
Simics Core
See Also
undisplay
down
Synopsis
down [N]
Description
Moves N frames down the stack (towards the innermost frame). N defaults to one.
Provided By
symtable
See Also
frame, up, stack-trace
dstc-disable
Synopsis
dstc-disable
dstc-enable
istc-disable
istc-enable
stc-status
Description
These commands are for advanced users only. They allow the user to control the usage of Simics internal caches. The Simulator Translation Caches (STCs) are designed to increase execution performance. The D-STC caches data translations (logical to physical to real (host) address), while the I-STC caches instruction translations of taken jumps. By default the STCs are on. When a memory hierarchy is connected (such as a cache module) it must have been designed to work along with the STCs otherwise it may not be called for all the memory transactions it is interested in. These commands can be used to detect if too many translations are kept in the STCs, causing the simulation to be faulty. Turning the STCs off means that current contents will be flushed and no more entries will be inserted into the STCs.
Provided By
Simics Core
dstc-enable
Synopsis
dstc-enable
dstc-disable
istc-disable
istc-enable
stc-status
Description
These commands are for advanced users only. They allow the user to control the usage of Simics internal caches. The Simulator Translation Caches (STCs) are designed to increase execution performance. The D-STC caches data translations (logical to physical to real (host) address), while the I-STC caches instruction translations of taken jumps. By default the STCs are on. When a memory hierarchy is connected (such as a cache module) it must have been designed to work along with the STCs otherwise it may not be called for all the memory transactions it is interested in. These commands can be used to detect if too many translations are kept in the STCs, causing the simulation to be faulty. Turning the STCs off means that current contents will be flushed and no more entries will be inserted into the STCs.
Provided By
Simics Core
echo
Synopsis
echo [(integer|float|"string")]
Description
Prints the string, integer, or float. Useful for annotating test scripts.
Provided By
Simics Core
else
Synopsis
else
if
Description
Runs a block of commands conditionally. Some examples:
if <condition> { commands }
if <condition> { commands } else { commands }
if <condition> { commands } else if <condition> { commands }
The if command returns the value of the last executed command in the block.
Provided By
Simics Core
See Also
while
enable
Synopsis
enable (-all|id)
disable (-all|id)
Description
Enable/disable instruction breakpoint. id is id number of the breakpoint to enable/disable. Use list-breakpoints to list breakpoint id:s. If '-all' is given all breakpoints will be enabled/disabled. Simics will not stop on a disabled breakpoint, however Simics will still count it.
Provided By
Simics Core
See Also
<breakpoint>.break, delete, ignore, list-breakpoints
enable-real-time-mode
Synopsis
enable-real-time-mode [speed] [check_interval]
disable-real-time-mode
Description
In some cases Simics might run faster (in real-time) than the machine it simulates; this can happen if the OS is in a tight idle loop or an instruction halts execution waiting for an interrupt. Running faster than the simulated machine can cause problems for interactive programs which might time-out faster than what the user can handle.

With the enable-real-time-mode command Simics will periodically check its actual running speed and sleep for a while if it is too high. This also reduces Simics CPU usage. speed specifies the percentage (as an integer) of the how fast the Simics target machine is allowed to run compared to the host machine; default is 100%. check_interval specifies how often the measurement should take place in milliseconds of the simulator time; default is 1000.

The disable-real-time-mode will deactivate any real-time behavior and Simics will run as fast as possible again.

Provided By
Simics Core
ethereal
Synopsis
ethereal [link] [device] ["ethereal-flags"]
Description
Runs the ethereal program in a separate console, with network traffic captured from simulated ethernet networks. The ethereal-flags are passed on unmodified to ethereal.
Provided By
ethernet-link
expect
Synopsis
expect (i1|"s1") (i2|"s2") [-v]
Description
If values i1 and i2 are not equal the simulator will print them and exit with error exit(1). -v prints the two values before comparing them.

This can be useful when writing scripts that want to assert a state in the simulator. Note that it only works with integer and string arguments.

Provided By
Simics Core
finish-function
Alias
finish, fin
Synopsis
finish-function
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.uncall-function
fpsr
Synopsis
fpsr [cpu-name]
Description
Prints the fields of the floating point status register (AR.fpsr).
Provided By
ia64-itanium
frame
Alias
f
Synopsis
frame [frame-number]
Description
Changes current stack frame to frame-number, or displays the current frame.
Provided By
symtable
See Also
stack-trace, psym, up, down
function-profile
Synopsis
function-profile profiler [maxfuncs] [cutoff]
Description
Lists the most interesting functions by their number of profile counts, as determined by profiler. No more than maxfuncs functions (10 by default) are listed, and not functions with fewer hits than cutoff.
Provided By
symtable
gdb-remote
Synopsis
gdb-remote [port] [cpu]
Description
Starts listening to incoming connection requests from GDB sessions (provided that a configuration has been loaded). Simics will listen to TCP/IP requests on port port, or 9123 by default. The GDB session will operate on the specified cpu, or the currently selected cpu by default. Use the gdb command target remote host:port to connect to Simics.
Provided By
gdb-remote
get
Synopsis
get address [size] [-l] [-b]
<memory-space>.get address [size] [-l] [-b]
Description
Get value of physical memory location. The size argument specifies how many bytes should be read. This defaults to 4, but can be any number of bytes between 1 and 8 (inclusive).

The -l and -b flags are used to select little-endian and big-endian byte order, respectively. If neither is given, the byte order of the currently selected processor is used.

This command operates on the physical memory associated with the current processor.

Provided By
Simics Core
See Also
x, set, signed
get-component-prefix
Synopsis
get-component-prefix
Description
Get the current component name prefix.
Provided By
Simics Core
See Also
set-component-prefix
help
Alias
h, man
Synopsis
help ["topic"]
Description
Prints help information on topic. topic can be a command, a class, an object, an interface, a module, a hap, an attribute or a function or type from the Simics API.

To refine your search, you may use filters in the topic as shown below: help topic = command:break The recognized filters are command:, class:, object:, interface:, module:, hap:, attribute: and api:.

By default, the help command does not provided tab-completion on topic for modules and api symbols unless the specific filter is provided.

Provided By
Simics Core
See Also
apropos, api-help, api-apropos
hex
Synopsis
hex value
Description
Returns the parameter as a string in hexadecimal notation. This is similar to print -x value.
Provided By
Simics Core
See Also
print
if
Synopsis
if
else
Description
Runs a block of commands conditionally. Some examples:
if <condition> { commands }
if <condition> { commands } else { commands }
if <condition> { commands } else if <condition> { commands }
The if command returns the value of the last executed command in the block.
Provided By
Simics Core
See Also
while
ignore
Synopsis
ignore id num
Description
Sets the ignore count for a breakpoint. This means that the next num times the breakpoint is reached it will not trigger (hap handlers will not be called). To break next time set num to 0.
Provided By
Simics Core
See Also
enable, list-breakpoints
import-alpha-components
Synopsis
import-alpha-components
Description
Imports all components from the "alpha-components" collection.
Provided By
alpha-components
import-arm-sa1110-components
Synopsis
import-arm-sa1110-components
Description
Imports all components from the "arm-sa1110-components" collection.
Provided By
arm-sa1110-components
import-fiesta-components
Synopsis
import-fiesta-components
Description
Imports all components from the "fiesta-components" collection.
Provided By
sun-components
import-ia64-components
Synopsis
import-ia64-components
Description
Imports all components from the "ia64-components" collection.
Provided By
ia64-components
import-isa-components
Synopsis
import-isa-components
Description
Imports all components from the "isa-components" collection.
Provided By
std-components
import-leon2-components
Synopsis
import-leon2-components
Description
Imports all components from the "leon2-components" collection.
Provided By
leon2-components
import-malta-components
Synopsis
import-malta-components
Description
Imports all components from the "malta-components" collection.
Provided By
malta-components
import-memory-components
Synopsis
import-memory-components
Description
Imports all components from the "memory-components" collection.
Provided By
std-components
import-niagara-simple-components
Synopsis
import-niagara-simple-components
Description
Imports all components from the "niagara-simple-components" collection.
Provided By
sun-components
import-pci-components
Synopsis
import-pci-components
Description
Imports all components from the "pci-components" collection.
Provided By
std-components
import-phy-components
Synopsis
import-phy-components
Description
Imports all components from the "phy-components" collection.
Provided By
std-components
import-pmppc-components
Synopsis
import-pmppc-components
Description
Imports all components from the "pmppc-components" collection.
Provided By
pmppc-components
import-ppc-simple-components
Synopsis
import-ppc-simple-components
Description
Imports all components from the "ppc-simple-components" collection.
Provided By
ppc-simple-components
import-ppc440gp-components
Synopsis
import-ppc440gp-components
Description
Imports all components from the "ppc440gp-components" collection.
Provided By
ppc440gp-components
import-ppc970fx-components
Synopsis
import-ppc970fx-components
Description
Imports all components from the "ppc970fx-components" collection.
Provided By
ppc970fx-components
import-serengeti-components
Synopsis
import-serengeti-components
Description
Imports all components from the "serengeti-components" collection.
Provided By
sun-components
import-std-components
Synopsis
import-std-components
Description
Imports all components from the "std-components" collection.
Provided By
std-components
import-sun-components
Synopsis
import-sun-components
Description
Imports all components from the "sun-components" collection.
Provided By
sun-components
import-sunfire-components
Synopsis
import-sunfire-components
Description
Imports all components from the "sunfire-components" collection.
Provided By
sun-components
import-telos-mote-components
Synopsis
import-telos-mote-components
Description
Imports all components from the "telos-mote-components" collection.
Provided By
telos-mote-components
import-timing-components
Synopsis
import-timing-components
Description
Imports all components from the "timing-components" collection.
Provided By
std-components
import-usb-components
Synopsis
import-usb-components
Description
Imports all components from the "usb-components" collection.
Provided By
std-components
import-x86-components
Synopsis
import-x86-components
Description
Imports all components from the "x86-components" collection.
Provided By
x86-components
instantiate-components
Synopsis
instantiate-components [-v] [ component ... ]
Description
Instantiates non-instantiated components. With no argument, all top-level components are collected and instantiated along with all components below them. If one or more components are specified as arguments, only these and the components below them are instantiated. -v will make the command print the name of the instantiated components.
Provided By
Simics Core
instruction-fetch-mode
Alias
ifm
Synopsis
instruction-fetch-mode ["mode"]
<processor>.instruction-fetch-mode ["mode"]
Description
This command selects how instruction fetches are sent for the memory hierarchy during simulation. If set to no-instruction-fetch, the memory hierarchy won't receive any instruction fetch. If set to instruction-cache-access-trace, the memory hierarchy will receive one (and only one) instruction fetch every time a new cache line is accessed. The size of this cache line is defined by the attribute instruction-fetch-line-size in the processor object. If set to instruction-fetch-trace, all instruction fetches will be visible. Note that on x86 target, instruction-cache-trace-access is not available. On some other, instruction-fetch-trace is actually instruction-cache-trace-access with a line size equal to the instruction size (sparc-v9). Using this command without argument will print out the current mode.
Provided By
Simics Core
instruction-profile-mode — deprecated
Alias
ipm
Synopsis
instruction-profile-mode ["mode"]
Description
This command is deprecated, use instruction-fetch-mode instead.

Sets the instruction fetch mode of all cpus on the system according to the mode passed as argument.

Provided By
Simics Core
interrupt-script-branch
Synopsis
interrupt-script-branch id
Description
Send a interrupt exception to a scripts branch. The argument is the script branch ID, that is returned by the script-branch command, and that is also listed by the list-script-branches command. The branch will wakeup and exit when it receives the exception.
Provided By
Simics Core
See Also
script-branch, list-script-branches
interrupt-status
Synopsis
interrupt-status [cpu-name]
Description
Displays the current status of pending external interrupts.
Provided By
ia64-itanium
istc-disable
Synopsis
istc-disable
dstc-disable
dstc-enable
istc-enable
stc-status
Description
These commands are for advanced users only. They allow the user to control the usage of Simics internal caches. The Simulator Translation Caches (STCs) are designed to increase execution performance. The D-STC caches data translations (logical to physical to real (host) address), while the I-STC caches instruction translations of taken jumps. By default the STCs are on. When a memory hierarchy is connected (such as a cache module) it must have been designed to work along with the STCs otherwise it may not be called for all the memory transactions it is interested in. These commands can be used to detect if too many translations are kept in the STCs, causing the simulation to be faulty. Turning the STCs off means that current contents will be flushed and no more entries will be inserted into the STCs.
Provided By
Simics Core
istc-enable
Synopsis
istc-enable
dstc-disable
dstc-enable
istc-disable
stc-status
Description
These commands are for advanced users only. They allow the user to control the usage of Simics internal caches. The Simulator Translation Caches (STCs) are designed to increase execution performance. The D-STC caches data translations (logical to physical to real (host) address), while the I-STC caches instruction translations of taken jumps. By default the STCs are on. When a memory hierarchy is connected (such as a cache module) it must have been designed to work along with the STCs otherwise it may not be called for all the memory transactions it is interested in. These commands can be used to detect if too many translations are kept in the STCs, causing the simulation to be faulty. Turning the STCs off means that current contents will be flushed and no more entries will be inserted into the STCs.
Provided By
Simics Core
license
Synopsis
license
Description
Prints the LICENSE that applies to this copy of Simics.
Provided By
Simics Core
list
Synopsis
list [(-s|-d)] (address|"location") [maxlines]
Description
List the source code corresponding to a given address, function or line. The location can be specified as

line or file:line --- list from given line

function or file:function --- list that function

address --- list from that address

At most maxlines lines of source or asm are printed. -s produces source intermixed with disassembly, and -d only disassembles.

Provided By
symtable
See Also
disassemble, whereis, pos, symval
list-attributes
Synopsis
list-attributes object ["attribute-name"]
Description
Print a list of all attributes that are registered in an object. For every attribute the type, as well as additional flags are listed. See the SIM_register_typed_attribute() documentation function for valid attribute types and flags. If an attribute name is given, the description for that particular attribute will be displayed.
Provided By
Simics Core
list-bookmarks
Alias
lb
Synopsis
list-bookmarks
Description
Lists time bookmarks.
Provided By
rev-execution
See Also
set-bookmark, delete-bookmark
list-breakpoints
Alias
ib, info-breakpoints
Synopsis
list-breakpoints [-all]
Description
Prints information about all breakpoints set. The following information is printed for memory breakpoints: the id (used by other commands to refer to the breakpoint), if the breakpoint is set on physical or virtual addresses and the access type (r = read, w = write, or x = execute), if enabled (see the enable command), the address range of the breakpoint, how many times the breakpoint has been triggered, and what memory space or context object it is set in.

If prefix, substring and/or pattern conditions are set it will be printed as well (see set-prefix, set-substr and set-pattern command).

Time breakpoints are also listed.

If -all is passed as argument, list-breakpoints will also list all internal breakpoints set for simulation purposes.

Provided By
Simics Core
See Also
<breakpoint>.break, delete, enable, ignore, set-prefix, set-substr, set-pattern
list-classes
Synopsis
list-classes [-l]
Description
Print a list of all configuration classes. The -l flag will reduce the list to classes that has been registered by loaded modules.
Provided By
Simics Core
list-components
Synopsis
list-components [component] [-s]
Description
List existing components with their names, types and and connectors. For each connector the destination component and connector is printed. If a top-level component is specified, only components below it in the hierarchy are listed. The -s flags can be used to get a short list.
Provided By
Simics Core
list-directories
Synopsis
list-directories
Description
Print a list of all directories in the Simics search path.
Provided By
Simics Core
list-failed-modules
Alias
module-list-failed
Synopsis
list-failed-modules ["substr"] [-v]
Description
Lists the modules (Simics extensions) that are not loadable, optionally only those matching substr.

Similar to list-modules but shows modules that will not load into Simics, and the reason why Simics refuses to load them (e.g., missing symbol, wrong version, ...).

If the -v flag is specified, show verbose information, with the full path to the module file and any library loader error message.

The MODULE column contains the name of the module or the filename of the shared library file if the module name could not be established.

If the module has the same name as another module, an X will be printed in the DUP column.

If the module could not be loaded since it was compiled or written for a different version of Simics, the version it was built for will be printed in the VERSION column.

The USR_VERS will contain the user version string, if provided.

The LINK column contains any linker error (cf. the dlerror(3) manpage).

When the -v flag is provided, the PATH column will contain linker information for the module.

Provided By
Simics Core
See Also
list-modules, module-list-refresh, load-module, add-module-directory
list-hap-callbacks
Synopsis
list-hap-callbacks ["hap"]
Description
Prints a list of all callbacks installed for hap, or for all haps if the argument is omitted.
Provided By
Simics Core
list-haps
Alias
hl
Synopsis
list-haps ["substring"]
Description
Prints a description of all haps whose names contain substring. If the name is omitted a list of all haps will be printed.
Provided By
Simics Core
list-modules
Alias
module-list
Synopsis
list-modules ["substr"] [-l] [-v]
Description
Lists all modules that can be loaded into Simics. If the optional substr argument is specified, only modules with a matching name will be printed. Use -v to get more information on the modules, and -l to only list loaded modules. The ABI version of modules is only printed if it differs from the current Simics ABI.
Provided By
Simics Core
See Also
list-failed-modules, module-list-refresh, load-module, add-module-directory
list-namespaces
Synopsis
list-namespaces [-n]
Description
Lists all namespaces (objects) and which classes or interfaces they belong to. A namespace is the same as a configuration object. Many objects implement commands local to them. These commands are invoked by giving the object name followed by a period and then the local command name; e.g., rec0.playback-start.

If the -n flag is given, the output will be sorted on the object name instead of the class name, which is the default.

Some objects also implement command interfaces. A command interface is a collection of commands that can be used by an object implementing this interface. For example, breakpoint is an interface that is implemented by objects of the memory-space class. This allows one to write phys_mem0.break 0xffc00 to set a breakpoint in the memory interface.

Objects implementing command interfaces are listed in the second half of output from this command.

Provided By
Simics Core
See Also
list-objects
list-objects
Synopsis
list-objects ["type"] [-n] [-a]
Description
Lists all configuration objects and the class they belong to.

You can specify a class or interface name as type. Only objects of that class or implementing that interface will then be listed.

The objects are sorted by class name by default. Use the -n flag to sort them by object name instead.

Component objects are printed, first, and then all other objects. To mix all objects in the same list, use the -a flag.

Provided By
Simics Core
See Also
list-namespaces
list-port-forwarding-setup
Synopsis
list-port-forwarding-setup
Description
Lists the current port forwarding and NAPT configuration.
Provided By
service-node
See Also
connect-real-network, connect-real-network-napt, connect-real-network-port-in, connect-real-network-port-out
list-script-branches
Synopsis
list-script-branches
Description
List all currently active script branches.
Provided By
Simics Core
See Also
script-branch, interrupt-script-branch
list-vars
Synopsis
list-vars
Description
Lists all Simics environment variables and their current values. Environment variables can be used to store temporary values. To set a variable, write variable = value at the Simics prompt. The value can be of type integer, string, or float. To access a variable, prefix the name with a $, e.g., $variable. A variable can be put wherever an expression can be used. For example:

simics> tmp = %pc + 4
simics> count = 10
simics> disassemble $tmp $count

They can also be accessed from Python by using the name space simenv:

simics> $foo = 1 + 4 * 4
simics> @print simenv.foo
17
simics> @simenv.bar = "hello"
simics> echo $bar
hello

Provided By
Simics Core
load-binary
Synopsis
load-binary filename [offset] [-v] [-pa] [-l]
<memory-space>.load-binary filename [offset] [-v] [-pa]
<processor>.load-binary filename [offset] [-v] [-pa]
Description
Load a binary (executable) file into the given physical or virtual memory space. The supported formats are ELF, Motorola S-Record, PE32 and PE32+. If an offset is supplied, it will be added to the load address taked from the file.

By default the virtual load address from the file is used, but the physical address can be used instead by specifying the -pa flag.

The -v flag turns on verbose mode, printing information about the loaded file.

When used as a global command, it will use the currently selected processor to find the memory space to load the binary into. If the -l flag is given, it will load it into the virtual memory space, otherwise it will use the physical memory space.

When using the namespace command on a processor object, it will load the binary into the virtual memory space of that processor.

When using the namespace command on a memory-space object, it will load the binary directly into that memory space.

The return value is the address of the execution entry point. This value is typically used in a call to set-pc.

load-binary uses Simics's Search Path and path markers (%simics%, %script%) to find the file to load. Refer to Simics User Guide (CLI chapter) for more information on how Simics's Search Path is used to locate files.

Provided By
Simics Core
See Also
add-directory
load-file
Synopsis
load-file filename [offset]
<memory-space>.load-file filename [offset]
Description
Loads a file with name filename into the memory space (defaulting to the current frontend processor's physical memory space), starting at physical address offset. Default offset is 0.

load-file uses Simics's Search Path and path markers (%simics%, %script%) to find the file to load. Refer to Simics User Guide (CLI chapter) for more information on how Simics's Search Path is used to locate files.

Provided By
Simics Core
See Also
add-directory
load-module
Synopsis
load-module "module"
Description
Load a module (Simics extension). Simics supports dynamically loadable modules. Read the Simics Users Guide for more info on how to write modules.
Provided By
Simics Core
See Also
list-modules, list-failed-modules, module-list-refresh, unload-module, add-module-directory
load-persistent-state
Synopsis
load-persistent-state file ["prefix"]
Description
Load persistent simulator state from a file. Persistent data typically includes disk images, NVRAM and flash memory contents and clock settings, i.e. data that survive reboots. The prefix argument can be used to add a name prefix to all objects in the persistent state file.
Provided By
Simics Core
See Also
save-persistent-state, read-configuration
load-rom
Synopsis
load-rom rom-file address [-v]
Description
The load-rom command loads a rom image (e.g. the SRM console) from a file into memory. The PC and the PAL base registers are set to the entry point as specified by the ROM header. Information extracted from the ROM header is written to the console if the verbose flag is set. Use -verbose to get more information during loading.
Provided By
alpha-ev5-turbo
log
Synopsis
log [count]
<log_object>.log [count]
Description
Display entries in log buffers. The namespace version displays the entries for a specific object, while the global command lists the entries of all object's log buffers but sorted by time. The optional argument is the number of entries to list. Only the last 10 entries are listed by default.
Provided By
Simics Core
See Also
<log_object>.log-group, log-level, log-size, log-type
log-level
Synopsis
log-level [level]
<log_object>.log-level [level]
Description
Objects in Simics can generate log messages on different log levels. These messages will be show in the Simics command line window if the log level for the object has been set high enough.

The default level is 1, and this is the lowest level that objects can report messages on. Setting it to 0 will inhibit output of all messages.

Messages are also added to an access log that can be viewed by the log command in Simics.

There are four log levels defined: 1 - important messages printed by default. 2 - "high-level" informative messages. 3 - standard debug messages. 4 - detailed information, such as register accesses.

Not all classes are converted to use this log level scheme.

Provided By
Simics Core
See Also
log, <log_object>.log-group, log-size, log-type
log-setup
Synopsis
log-setup [-time-stamp] [-no-time-stamp] [-file-only] [-no-file-only] [-no-log-file] [logfile]
Description
The -time-stamp flag will cause further log output to include a time stamp, i.e. the name of the current processor together with the program counter and step count for this CPU. Time stamp output is disabled with -no-time-stamp. A file that receives all log output can be specified with the logfile argument. -no-log-file disables an existing log file. Even if a log file is specified, all output is printed on the console, unless -file-only is used. Use -no-file_only to re-enable output. Called without arguments, the command will print the current setup.
Provided By
Simics Core
See Also
log, <log_object>.log-group, log-size, log-type
log-size
Synopsis
log-size [size]
<log_object>.log-size [size]
Description
The namespace version of this command changes the buffer size (number of entries) for log messages and I/O trace entries for an objects. The global command applies to all log objects. When called with no arguments, the size of the log buffers are listed.
Provided By
Simics Core
See Also
log, <log_object>.log-group, log-level, log-type
log-type
Synopsis
log-type [-add] [-sub] ["log-type"]
<log_object>.log-type [-add] [-sub] ["log-type"]
Description
Log messages are categorised into one of the several log types. By default, messages of all types are handled in the same way. This command can be used to select one or several types. Only messages of the selected types will be logged and displayed, as defined by the log-level command. The flags -add and -sub can be used to add and remove a single log type. The log types are documented with the log_type_t data type, and are Info, Error, Undefined, Spec_Violation, Target_Error, Unimplemented. All types can be enabled by setting log-type to all.
Provided By
Simics Core
See Also
log, <log_object>.log-group, log-level, log-size
logical-to-physical
Alias
l2p
Synopsis
logical-to-physical [cpu-name] address
<processor>.logical-to-physical address
Description
Translate the given logical address to a physical one. The operation is performed as read from processor cpu-name. On x86 a logical address can be given on the form <segment register>:<offset> or l:<linear address>. If no prefix is given ds:<offset> will be assumed. If the CPU is omitted the current CPU will be used. No side-effects will occur, i.e. if the translation is not in the TLB. The method variant of this command can also be used.
Provided By
Simics Core
ls
Synopsis
ls
Description
List files in working directory of Simics. Works like ls in a Unix shell, but does not take any parameters.
Provided By
Simics Core
See Also
cd, pwd
magic-break-disable
Synopsis
magic-break-disable
magic-break-enable
magic-break-query
Description
Installs (magic-break-enable) or removes (magic-break-disable) the magic breakpoint handler. A magic breakpoint is a magic instruction with argument 0, except on the SPARC target, where it is a magic instruction with the top 6 bits of the 22-bit parameter field set to 000100 (binary). Note that break-hap Core_Magic_Instruction will break on all magic instructions.
Provided By
Simics Core
magic-break-enable
Synopsis
magic-break-enable
magic-break-disable
magic-break-query
Description
Installs (magic-break-enable) or removes (magic-break-disable) the magic breakpoint handler. A magic breakpoint is a magic instruction with argument 0, except on the SPARC target, where it is a magic instruction with the top 6 bits of the 22-bit parameter field set to 000100 (binary). Note that break-hap Core_Magic_Instruction will break on all magic instructions.
Provided By
Simics Core
magic-break-query
Synopsis
magic-break-query
magic-break-disable
magic-break-enable
Description
Installs (magic-break-enable) or removes (magic-break-disable) the magic breakpoint handler. A magic breakpoint is a magic instruction with argument 0, except on the SPARC target, where it is a magic instruction with the top 6 bits of the 22-bit parameter field set to 000100 (binary). Note that break-hap Core_Magic_Instruction will break on all magic instructions.
Provided By
Simics Core
max
Synopsis
max arg1 arg2
Description
Returns the larger value of arg1 and arg2.
Provided By
Simics Core
memory-usage
Synopsis
memory-usage [-verbose]
Description
Print the memory map and usage info for the Simics session. With the -verbose flag, individual mappings and the top dynamic allocation sites will also be shown.
Provided By
perfanalyze-client
min
Synopsis
min arg1 arg2
Description
Returns the smaller value of arg1 and arg2.
Provided By
Simics Core
module-list-refresh
Synopsis
module-list-refresh
Description
Refresh (reload) the list of all Simics modules.
This command causes Simics to re-query all modules currently not loaded. This can be used after changing or adding a module that Simics, when started, considered as non-loadable.
Provided By
Simics Core
See Also
list-modules, list-failed-modules, load-module
native-path
Synopsis
native-path "filename"
Description
Converts a path to its host native form. On Unix, this command returns filename unchanged. On Windows, it translates Cygwin-style paths to native Windows paths. Refer to the documentation SIM_native_path(), for a detailed description of the conversions made.

This command can be used for portability when opening files residing on the host filesystem.

Provided By
Simics Core
network-helper
Synopsis
network-helper [-pcap] [helper]
Description
Sets the file name of the helper executable that opens the host network interface for real-network connections using raw access. This helper, openif in the distribution, needs privileges to run and should be installed in such a way that it is run as root, typically by installing it as setuid root. Simics can use PCAP to read packets from the network device instead of accessing it directly. Set the -pcap flag, and no handler to use PCAP instead. Without arguments, displays the current setting.

This command has no effect under Windows.

Provided By
ethernet-link
new-arm-sa1110-system
Synopsis
new-arm-sa1110-system ["name"] cpu_frequency [memory_megs]
Description
Creates an instantiated component of the class "arm-sa1110-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
arm-sa1110-components
See Also
create-arm-sa1110-system
new-branch-recorder
Synopsis
new-branch-recorder "name" "address_type"
Description
Create a new branch recorder object called name, to record branches using addresses of type address_type (either physical or virtual). The branch recorder is initially not bound to any processor.
Provided By
mips-4kc-turbo
new-central-server
Synopsis
new-central-server [port] ["file"] [min-latency]
Description
Create a Simics Central server object. The server will by default listen to Simics Central client connections on TCP port 1909 and, on systems supporting it, UNIX file socket /tmp/simics-central.user. It will also accept connections from a Central client in the same Simics process.

The port argument can be used to change the TCP listen port. By setting it to -1, the server will not listen for TCP connections. By setting it to 0, the server will choose an available TCP port number. The used port number will be printed when the server successfully opened the port.

The file argument can be used to change the file name for the UNIX file socket. And empty string disables it.

The min-latency argument specifies the minimum latency in nanoseconds for inter-simics communication enforced by Simics Central.

Provided By
central
new-context
Synopsis
new-context "name"
Description
Create a new context object called name. The context is initially not bound to any processor.
Provided By
Simics Core
See Also
set-context, <context>.symtable
new-context-switcher
Synopsis
new-context-switcher ["name"] "tracker"
Description
Create a new context switcher. It will change the current context of the processors to match the currently active process. The tracker parameter specifies the tracker object it should rely on for process information.
Provided By
context-switcher
new-cpu-mode-tracker
Synopsis
new-cpu-mode-tracker ["name"]
Description
Create a new cpu mode tracker. The tracker's set of processors will initially be empty. You can add the processors you want it to watch with its add-processors command.
Provided By
cpu-mode-tracker
See Also
new-context-switcher, <tracker>.add-processor
new-ddr-memory-module
Synopsis
new-ddr-memory-module ["name"] [rows] [columns] [ranks] [module_data_width] [primary_width] [ecc_width] [banks] [rank_density] ["module_type"] [cas_latency] ["speed"]
Description
Creates an instantiated component of the class "ddr-memory-module". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
memory-components
See Also
create-ddr-memory-module
new-ddr2-memory-module
Synopsis
new-ddr2-memory-module ["name"] [rows] [columns] [ranks] [module_data_width] [primary_width] [ecc_width] [banks] [rank_density] ["module_type"] [cas_latency]
Description
Creates an instantiated component of the class "ddr2-memory-module". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
memory-components
See Also
create-ddr2-memory-module
new-dummy-component
Synopsis
new-dummy-component ["name"]
Description
Creates an instantiated component of the class "dummy-component". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-dummy-component
new-ebony-board
Synopsis
new-ebony-board ["name"] "rtc_time" cpu_frequency "mac_address0" "mac_address1"
Description
Creates an instantiated component of the class "ebony-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ppc440gp-components
See Also
create-ebony-board
new-etg
Synopsis
new-etg ["name"] link "ip" "netmask" "target" ["gw"] [idx] [pps] [size]
Description
Create a new etg object.
Provided By
etg
new-ethernet-link
Synopsis
new-ethernet-link ["name"] [latency]
Description
Creates a new ethernet-link object that can be used to connect Ethernet devices.

As of Simics 3.0 this command is deprecated. The new-std-ethernet-link command should be used in component based configurations.

The latency argument specifies the latency in nanoseconds for communication over the link.

Provided By
ethernet-link
See Also
new-std-ethernet-link, new-std-service-node
new-file-cdrom
Synopsis
new-file-cdrom file ["name"]
Description
Create a new file-cdrom object from file (which should be a valid CD-ROM (ISO) image), named name. If name is not given, an object name is derived from the file name. This object can then be inserted into a simulated CD-ROM device using the <device>.insert command.
Provided By
file-cdrom
new-gdb-remote
Synopsis
new-gdb-remote ["name"] [port] [cpu] ["architecture"]
Description
Starts listening to incoming connection requests from GDB sessions (provided that a configuration has been loaded). Simics will listen to TCP/IP requests on port specified by port, or 9123 by default. If port is given as zero, a random port will be selected. The GDB session will operate on the specified cpu, or the currently selected cpu by default.

The architecture argument can be used to specify a particular architecture for the GDB session. It should be the architecture name used by Simics and not the GDB architecture name. For example, if you are debugging a 32-bit program on a 64-bit x86 processor, you may want to specify x86 as architecture and run set architecture i386 in GDB before connecting. If not given, the architecture of the CPU will be used.

Use the GDB command target remote host:port to connect to Simics.

Provided By
gdb-remote
new-host-cdrom
Synopsis
new-host-cdrom device ["name"]
Description
Create a new host-cdrom object from device (which should be a valid CD-ROM device, e.g. /dev/cdrom on linux. If name is not given, an object name is derived from the device name. This object can then be inserted into a simulated CD-ROM device using the <device>.insert command.
Provided By
host-cdrom
new-ia64-460gx-system
Synopsis
new-ia64-460gx-system ["name"] memory_megs "rtc_time"
Description
Creates an instantiated component of the class "ia64-460gx-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ia64-components
See Also
create-ia64-460gx-system
new-leon2-simple
Synopsis
new-leon2-simple ["name"] cpu_frequency prom_size has_sram sram_size sdram_size num_windows has_v8e_mac has_v8_mul has_v8_div
Description
Creates an instantiated component of the class "leon2-simple". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
leon2-components
See Also
create-leon2-simple
new-linux-process-tracker
Synopsis
new-linux-process-tracker ["name"] ["kernel"]
Description
Create a new Linux process tracker. You may choose a named set of parameters by giving the kernel argument; otherwise, you must set the parameters manually, or use the autodetect-parameters command.

The tracker's set of processors will initially be empty. You can add the processors you want it to watch with its add-processors command.

Provided By
linux-process-tracker
See Also
new-context-switcher, <tracker>.add-processor
new-niagara-simple-system
Synopsis
new-niagara-simple-system ["name"] cpu_frequency num_cores strands_per_core "rtc_time"
Description
Creates an instantiated component of the class "niagara-simple-system". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
niagara-simple-components
See Also
create-niagara-simple-system
new-pcie-pex8524
Synopsis
new-pcie-pex8524 ["name"] ["ports"] [up_port_number] [nt_port_number]
Description
Creates an instantiated component of the class "pcie-pex8524". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
See Also
create-pcie-pex8524
new-pmppc-board
Synopsis
new-pmppc-board ["name"] "cpu_class" cpu_frequency timebase_frequency "mac_address" "rtc_time"
Description
Creates an instantiated component of the class "pmppc-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pmppc-components
See Also
create-pmppc-board
new-ppc-simple
Synopsis
new-ppc-simple ["name"] "cpu_class" cpu_frequency memory_megs
Description
Creates an instantiated component of the class "ppc-simple". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ppc-simple-components
See Also
create-ppc-simple
new-ppc32-linux-process-tracker
Synopsis
new-ppc32-linux-process-tracker ["name"] [thread_offset] [pid_offset] ["kernel"]
Description
Create a new ppc32-linux process tracker. You must either specify the thread_offset and pid_offset integer parameters, or choose a named set of parameters by giving the kernel argument.

The tracker's set of processors will initially be empty. You can add the processors you want it to watch with its add-processors command.

Provided By
ppc32-linux-process-tracker
See Also
new-context-switcher, <tracker>.add-processor
new-ppc64-linux-process-tracker
Synopsis
new-ppc64-linux-process-tracker ["name"] [task_struct_offset] [pid_offset] ["kernel"]
Description
Create a new ppc64-linux process tracker. You must either specify the task_struct_offset and pid_offset integer parameters, or choose a named set of parameters by giving the kernel argument.

The tracker's set of processors will initially be empty. You can add the processors you want it to watch with its add-processors command.

Provided By
ppc64-linux-process-tracker
See Also
new-context-switcher, <tracker>.add-processor
new-ppc970-simple
Synopsis
new-ppc970-simple ["name"] cpu_frequency memory_megs [map_offset] ["time_of_day"]
Description
Creates an instantiated component of the class "ppc970-simple". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
ppc970fx-components
See Also
create-ppc970-simple
new-sample-gcache
Synopsis
new-sample-gcache ["name"]
Description
Creates an instantiated component of the class "sample-gcache". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
See Also
create-sample-gcache
new-sample-ma-model
Synopsis
new-sample-ma-model ["name"]
Description
Creates an instantiated component of the class "sample-ma-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
See Also
create-sample-ma-model
new-sample-ooo-model
Synopsis
new-sample-ooo-model ["name"]
Description
Creates an instantiated component of the class "sample-ooo-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
See Also
create-sample-ooo-model
new-sample-x86-ma-model
Synopsis
new-sample-x86-ma-model ["name"]
Description
Creates an instantiated component of the class "sample-x86-ma-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
timing-components
See Also
create-sample-x86-ma-model
new-sdram-memory-module
Synopsis
new-sdram-memory-module ["name"] [rows] [columns] [ranks] [module_data_width] [primary_width] [ecc_width] [banks] [rank_density] ["module_type"] [cas_latency]
Description
Creates an instantiated component of the class "sdram-memory-module". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
memory-components
See Also
create-sdram-memory-module
new-serengeti-3800-chassis
Synopsis
new-serengeti-3800-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates an instantiated component of the class "serengeti-3800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
See Also
create-serengeti-3800-chassis
new-serengeti-4800-chassis
Synopsis
new-serengeti-4800-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates an instantiated component of the class "serengeti-4800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
See Also
create-serengeti-4800-chassis
new-serengeti-4810-chassis
Synopsis
new-serengeti-4810-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates an instantiated component of the class "serengeti-4810-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
See Also
create-serengeti-4810-chassis
new-serengeti-6800-chassis
Synopsis
new-serengeti-6800-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates an instantiated component of the class "serengeti-6800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
See Also
create-serengeti-6800-chassis
new-serengeti-cluster-chassis
Synopsis
new-serengeti-cluster-chassis ["name"] hostid "mac_address" "rtc_time"
Description
Creates an instantiated component of the class "serengeti-cluster-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
serengeti-components
See Also
create-serengeti-cluster-chassis
new-serial-link
Synopsis
new-serial-link ["name"] [throttle]
Description
Creates a new serial-link object that can be used to connect Serial devices. As of Simics 3.0 this command is deprecated. The new-std-serial-link command should be used in component based configurations.
Provided By
serial-link
See Also
new-std-serial-link
new-service-node
Synopsis
new-service-node ["name"] [link] ["ip"] ["netmask"]
Description
Creates a new service-node object, and optionally connects it to an Ethernet link.

As of Simics 3.0 this command is deprecated. The new-std-service-node command should be used in component based configurations.

If an link argument is provided, it should be the name of an existing ethernet-link object. When a link is specified, the ip argument should give the IP address that the service node will use on the link, and the netmask argument the netmask. Optionally, the netmask may be given in the ip argument as a /bits suffix. The netmask may also left out entirely, in which case it will default to 255.255.255.0.

Provided By
service-node
See Also
new-std-service-node, <service-node>.connect
new-south-bridge-6300esb
Synopsis
new-south-bridge-6300esb ["name"] "bios" [flash_size]
Description
Creates an instantiated component of the class "south-bridge-6300esb". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
pci-components
See Also
create-south-bridge-6300esb
new-std-etg
Synopsis
new-std-etg ["name"] "mac_address" "ip" "netmask" "dst_ip" "gateway_ip" pps packet_size
Description
Creates an instantiated component of the class "std-etg". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-etg
new-std-ethernet-link
Synopsis
new-std-ethernet-link ["name"] ["link_name"] [frame_echo]
Description
Creates an instantiated component of the class "std-ethernet-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-ethernet-link
new-std-graphics-console
Synopsis
new-std-graphics-console ["name"] [window]
Description
Creates an instantiated component of the class "std-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-graphics-console
new-std-host-serial-console
Synopsis
new-std-host-serial-console ["name"]
Description
Creates an instantiated component of the class "std-host-serial-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-host-serial-console
new-std-ms1553-link
Synopsis
new-std-ms1553-link ["name"]
Description
Creates an instantiated component of the class "std-ms1553-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-ms1553-link
new-std-pcmcia-flash-disk
Synopsis
new-std-pcmcia-flash-disk ["name"] size ["file"]
Description
Creates an instantiated component of the class "std-pcmcia-flash-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-pcmcia-flash-disk
new-std-serial-link
Synopsis
new-std-serial-link ["name"]
Description
Creates an instantiated component of the class "std-serial-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-serial-link
new-std-server-console
Synopsis
new-std-server-console ["name"] telnet_port
Description
Creates an instantiated component of the class "std-server-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-server-console
new-std-service-node
Synopsis
new-std-service-node ["name"]
Description
Creates an instantiated component of the class "std-service-node". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-service-node
new-std-text-console
Synopsis
new-std-text-console ["name"] ["title"] ["bg_color"] ["fg_color"] ["x11_font"] ["win32_font"] [width] [height]
Description
Creates an instantiated component of the class "std-text-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-text-console
new-std-text-graphics-console
Synopsis
new-std-text-graphics-console ["name"]
Description
Creates an instantiated component of the class "std-text-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
std-components
See Also
create-std-text-graphics-console
new-sun-type5-keyboard
Synopsis
new-sun-type5-keyboard ["name"]
Description
Creates an instantiated component of the class "sun-type5-keyboard". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
See Also
create-sun-type5-keyboard
new-sun-type5-mouse
Synopsis
new-sun-type5-mouse ["name"]
Description
Creates an instantiated component of the class "sun-type5-mouse". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
sun-components
See Also
create-sun-type5-mouse
new-symtable
Synopsis
new-symtable ["name"] [file] [start] [-t]
Description
Creates a new symbol table, calling it name (or inventing a new name if omitted), and optionally loads debug info from file, using the Simics search path to do so. If start is given, it is the (absolute) starting address of the file's code. If -t is specified, start is interpreted as the address of the .text section (similarly to GDB); otherwise start is taken to be the address of the first executable segment. If the current context of the selected cpu does not have an associated symbol table, it will be set to the newly created symbol table.
Provided By
symtable
See Also
<symtable>.load-symbols, set-context
new-telos-mote
Synopsis
new-telos-mote ["name"] cpu_frequency location_x location_y location_z
Description
Creates an instantiated component of the class "telos-mote". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
Provided By
telos-mote-components
See Also
create-telos-mote
new-tracer
Synopsis
new-tracer
Description
Create a new tracer that connects to each CPU's memory space and traces instruction and data accesses.
Provided By
trace
See Also
<base-trace-mem-hier>.start
new-x86-linux-process-tracker
Synopsis
new-x86-linux-process-tracker ["name"] [pid_offset] [kernel_stack_size] ["kernel"]
Description
Create a new x86-linux process tracker. You must either specify the kernel_stack_size and pid_offset integer parameters, or choose a named set of parameters by giving the kernel argument.

The tracker's set of processors will initially be empty. You can add the processors you want it to watch with its add-processors command.

Provided By
x86-linux-process-tracker
See Also
new-context-switcher, <tracker>.add-processor
next-instruction
Alias
nexti, ni
Synopsis
next-instruction
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
next-line
Alias
next, n
Synopsis
next-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
not
Synopsis
not arg
Description
Returns 1 if arg is zero, and 0 if not.
Provided By
Simics Core
or
Synopsis
arg1 or arg2
Description
Returns 1 if arg1 or arg2 is non-zero, and 0 if not.
Provided By
Simics Core
output-file-start
Synopsis
output-file-start filename
Description
Send output to filename. Any output displayed in the Simics console that goes through the output handler API will be written to the file.
Provided By
Simics Core
See Also
output-file-stop
output-file-stop
Synopsis
output-file-stop [filename]
Description
Stop sending output to file. If no filename is given, then the command will disable all file output.
Provided By
Simics Core
See Also
output-file-start
output-radix
Synopsis
output-radix [base] [group]
Description
Changes or displays the default output radix for numbers. It can be set to 2 for binary, 8 for octal, 10 for decimal, or 16 for hexadecimal output.

If group is non-zero, numbers will be grouped in groups of group digits, separated by underscores (_).

Currently, this only affects the output of the print command, and how return values of commands are displayed.

Without arguments, the current setting will be shown.

Provided By
Simics Core
See Also
digit-grouping, print
pcapdump
Synopsis
pcapdump filename [link] [device]
Description
A trace of network traffic is saved to a file, in the format implemented by libpcap, for use with libpcap based applications such as tcpdump and ethereal.
Provided By
ethernet-link
pdisable
Synopsis
pdisable [(cpu-name|-all)]
<processor>.disable
<processor>.enable
penable [(cpu-name|-all)]
Description
Enables a processor. If no processor is specified, the current processor will be enabled. If the flag -all is passed, all processors will be enabled.

pdisable takes processor as parameter. If no processor is given, it will list all enabled processors. The method variant can also be used to disable a processor. A disabled processor is simply stalled for an infinite amount of time. Make sure that you always have at least one enabled processor.

Provided By
Simics Core
penable
Synopsis
penable [(cpu-name|-all)]
<processor>.disable
<processor>.enable
pdisable [(cpu-name|-all)]
Description
Enables a processor. If no processor is specified, the current processor will be enabled. If the flag -all is passed, all processors will be enabled.

pdisable takes processor as parameter. If no processor is given, it will list all enabled processors. The method variant can also be used to disable a processor. A disabled processor is simply stalled for an infinite amount of time. Make sure that you always have at least one enabled processor.

Provided By
Simics Core
pfregs
Synopsis
pfregs [cpu-name] ["fr"]
Description
Prints the floating point register file of the processor cpu-name. The output includes the values formatted in both floating-point form and raw hexadecimal form.
Provided By
ia64-itanium
Note
The floating-point values printed may be inaccurate depending on differences in the range and precision between Python floats and IA64 floating point values.
pfregs — deprecated
Synopsis
pfregs [cpu-name] ["fr"]
Description
This command is deprecated, use pregs instead.

Print binary contents of the floating point registers in hexadecimal form.

Provided By
alpha-ev5-turbo
Note
The values printed may be inaccurate on hosts that are not IEEE-754 compliant.
pfregs
Synopsis
pfregs [cpu-name] ["fr"]
Description
Prints the floating point register file of the processor cpu-name. The output includes the values formatted in both floating-point form and raw hexadecimal form.
Provided By
ia64-itanium
Note
The floating-point values printed may be inaccurate depending on differences in the range and precision between Python floats and IA64 floating point values.
pfregs — deprecated
Synopsis
pfregs [cpu-name] ["fr"]
Description
This command is deprecated, use pregs instead.

Print binary contents of the floating point registers in hexadecimal form.

Provided By
alpha-ev5-turbo
Note
The values printed may be inaccurate on hosts that are not IEEE-754 compliant.
pid
Synopsis
pid
Description
Outputs the process identity of the Simics process itself, useful for various things (such as attaching a remote debugger).
Provided By
Simics Core
pipe
Synopsis
pipe "command" "pipe"
Description
This command runs command at the Simics prompt and pipes the output (stdout) through the external program pipe's stdin. Available on UNIX hosts only.
Provided By
Simics Core
piprs
Synopsis
piprs [cpu-name] [-verbose]
Description
Print the contents of all internal registers of processor cpu-name. If no CPU is specified the current CPU will be selected. With -verbose, piprs will also print the description of each register.
Provided By
alpha-ev5-turbo
popd
Synopsis
popd [-n]
Description
Pops a directory off the directory stack and, unless the -n option is specified, change current working directory to that directory.
Provided By
Simics Core
See Also
dirs, pushd
pos
Synopsis
pos (line|"function")
Description
Finds the address of a source line or a function in a given file (e.g., myfile.c:4711 or myfile.c:myfunction). If only a line number is specified, the command looks at the current value of the program counter to determine the current file. (If this command is called from the symtable namespace, no current file is defined.) It may be necessary to put the argument inside double quotes for it to be parsed correctly.
Provided By
symtable
See Also
stack-trace, psym, symval
pow
Synopsis
arg1 pow arg2
Description
Return the arg1 to the power of arg2.
Provided By
Simics Core
pregs
Synopsis
pregs [cpu-name] [-all]
<processor>.pregs [-all]
Description
Prints the current integer register file of the processor cpu_name. If no CPU is specified, the current CPU will be selected. The -all flag causes additional registers, such as control registers and floating point registers to be printed.
Provided By
Simics Core
pregs-all
Synopsis
pregs-all [cpu-name]
Description
SPARC V9 command. Displays the integer processor registers in all windows, as well as some most control registers such as the program counter.
Provided By
sparc-niagara-turbo
pregs-altivec
Synopsis
pregs-altivec [cpu-name]
<ppc7400>.pregs-altivec
Description
Prints the altivec vector register file of the processor cpu_name. If no CPU is specified, the current CPU will be selected.
Provided By
ppc7400-turbo
pregs-fpu
Synopsis
pregs-fpu [cpu-name] [-f] [-x] [-i] [-b]
<ppc603e>.pregs-fpu [-f] [-x] [-i] [-b]
Description
Prints the contents of the floating point registers.
This command can take one subregister size flag and one formatting flag.
The formatting flags -f, -x, and -i select the formatting of the output. The -f flag prints the floating-point values of the registers. The -x flag prints the contents of the registers as hexadecimal integers. The -i flag prints the contents of the registers as decimal integers. With the -b flag, the registers are printed in binary floating point form.
Provided By
ppc603e-turbo
pregs-hyper
Synopsis
pregs-hyper ["cpu-name"] [-all]
<processor>.pregs-hyper [-all]
<processor>.pregs-hyper [-all]
Description
Prints the UltraSPARC T1 specific hypervisor registers for cpu cpu-name. -all will provide a complete listing. If no CPU is specified, the currently selected frontend processor will be used.
Provided By
sparc-niagara
See Also
pregs, pregs-all
pregs-hyper
Synopsis
pregs-hyper ["cpu-name"] [-all]
Description
Prints the UltraSPARC T1 specific hypervisor registers for cpu cpu-name. -all will provide a complete listing. If no CPU is specified, the currently selected frontend processor will be used.
Provided By
sparc-niagara-turbo
See Also
pregs, pregs-all
pregs-hyper
Synopsis
pregs-hyper ["cpu-name"] [-all]
<processor>.pregs-hyper [-all]
<processor>.pregs-hyper [-all]
Description
Prints the UltraSPARC T1 specific hypervisor registers for cpu cpu-name. -all will provide a complete listing. If no CPU is specified, the currently selected frontend processor will be used.
Provided By
sparc-niagara
See Also
pregs, pregs-all
pregs-hyper
Synopsis
pregs-hyper ["cpu-name"] [-all]
Description
Prints the UltraSPARC T1 specific hypervisor registers for cpu cpu-name. -all will provide a complete listing. If no CPU is specified, the currently selected frontend processor will be used.
Provided By
sparc-niagara-turbo
See Also
pregs, pregs-all
print
Alias
p
Synopsis
print [(-x|-o|-b|-s|-d)] value [size]
Description
Prints value in hexadecimal (-x), decimal (-d), octal (-o), or binary (-b) notation. Default is to use the notation specified by the output-radix command.

Use -s to convert the value to signed integers. size is the bit width to use. E.g., print -x 257 8 will print 0x1. Valid sizes are 8, 16, 32, 64, and 128 bits. Default size is 64.

Provided By
Simics Core
See Also
output-radix
print-directories — deprecated
Synopsis
print-directories
Description
This command is deprecated, use list-directories instead.

Provided By
Simics Core
print-double-regs — deprecated
Synopsis
print-double-regs
Description
This command is deprecated, use <sparc_v9>.pregs-fpu instead.

SPARC V9 command. Prints contents of the 32 double precision floating point registers. Note that the first 16 overlaps with the 32 single precision floating points registers.

Provided By
sparc-niagara-turbo
Note
The values printed may be inaccurate on hosts that are not IEEE-754 compliant
See Also
print-float-regs, print-float-regs-raw
print-dtlb — deprecated
Synopsis
print-dtlb [cpu-name]
Description
This command is deprecated, use <ppc603e>.print-dtlb instead.

Prints the contents of the data TLB of the processor cpu_name. If no CPU is specified, the current CPU will be selected.

Provided By
ppc603e-turbo
print-event-queue
Alias
peq
Synopsis
print-event-queue [cpu-name] [queue] [-i]
Description
The simulator keeps an event queue for each processor. Interrupts, exceptions, and other events are posted on this event queue. For each event, the time to its execution and a brief description of it are printed. The time unit depends on the timing model of the queue; the default is the number of instructions before the event is trigged. If no CPU is specified, the selected frontend CPU is used. A queue argument of 0 means that only the step queue is printed, and for 1, only the time queue. Default is to print both queues. The flag -i enables printing of Simics internal events.
Provided By
Simics Core
print-float-regs — deprecated
Synopsis
print-float-regs
Description
This command is deprecated, use <sparc_v9>.pregs-fpu instead.

SPARC V9 command. Prints contents of the single-precision floating point registers in exponent form (32 of them).

Provided By
sparc-niagara-turbo
Note
The values printed may be inaccurate on hosts that are not IEEE-754 compliant.
See Also
print-double-regs, print-float-regs-raw
print-float-regs-raw — deprecated
Synopsis
print-float-regs-raw
Description
This command is deprecated, use <sparc_v9>.pregs-fpu instead.

The entire floating point register bank is printed as integers, each double-precision register as a 64-bit number. The first half corresponds to the 32 single precision floating-point registers and the first 16 double precision registers, the second half is the rest of the doubles.

Provided By
sparc-niagara-turbo
See Also
print-float-regs, print-double-regs
print-itlb — deprecated
Synopsis
print-itlb [cpu-name]
Description
This command is deprecated, use <ppc603e>.print-itlb instead.

Prints the contents of the instruction TLB of the processor cpu_name. If no CPU is specified, the current CPU will be selected.

Provided By
ppc603e-turbo
print-statistics
Alias
pstats
Synopsis
print-statistics [(cpu-name|-all)]
<processor>.print-statistics
Description
Prints various statistics from the simulation. The print-statistics command prints statistics for the currently selected CPU if no argument is given and for all CPUs if the -all flag given. Any statistics that have been compiled into the simulator are printed, as well as user-defined per-mode counters.
Provided By
Simics Core
print-time
Alias
ptime
Synopsis
print-time [cpu-name] [-s] [-c] [-all]
Description
Prints the number of steps and cycles that a processor has executed. The cycle count is also displayed as simulated time in seconds.

If called from a processor namespace (e.g., cpu0.print-time), the time for that processor is printed. Otherwise, the time for the current processor is printed, or, if the -all flag is given, the time for all processors.

if the -c flag used, the cycle count for the processor is returned and nothing is printed. The -s flag is similar and returns the step count.

A step is a completed instruction or an exception. An instruction that fails to complete because of an exception will count as a single step, including the exception.

Provided By
Simics Core
print-tlb — deprecated
Synopsis
print-tlb [cpu-name]
Description
This command is deprecated, use <mips>.print-tlb instead.

Prints the contents of the TLB of the processor cpu_name. If no CPU is specified, the current CPU will be selected.

Provided By
mips-4kc-turbo
pselect
Alias
psel
Synopsis
pselect [cpu-name]
Description
Use this command to select a default processor for the frontend. Many commands that have a processor as argument operates on the default processor when the argument is left out. Note that selecting processors does not affect in which order they are executed when multiprocessing is simulated.

Without any argument, this command will print the currently selected processor.

Provided By
Simics Core
pstatus
Synopsis
pstatus
Description
Show the enabled/disabled status of all processors in the Simics session.
Provided By
Simics Core
psym
Synopsis
psym "expression"
Description
Evaluates expression in the current stack frame, and prints the result in a human-readable form. The only C operators allowed are casts, indirection, member selection, and sizeof (thus no arithmetic). You may need to surround the expression by double quotes if it contains certain meta-characters.
Provided By
symtable
See Also
stack-trace, frame, symval
pushd
Synopsis
pushd [-n] [path]
Description
Pushes the directory path on top of the directory stack, or exchanges the topmost two directories on the stack. If -n is given, only change the contents of the stack, but do not change current working directory.
Provided By
Simics Core
See Also
dirs, popd
pwd
Synopsis
pwd
Description
Print the working directory of Simics. Similar to the shell command 'pwd' (print working directory).
Provided By
Simics Core
See Also
cd, ls
python
Synopsis
python "exp"
Description
exp will be evaluated in the Python environment and the result returned to the frontend. This can also be done by enclosing the Python code within backquotes (`); e.g., print -x `SIM_step_count(SIM_current_processor())`.

Both expressions and statements can be run, but for statements the @ command can be used instead.

run-python-file uses Simics's Search Path and path markers (%simics%, %script%) to find the script to run. Refer to Simics User Guide (CLI chapter) for more information.

Provided By
Simics Core
See Also
@, run-python-file
quit
Alias
q, exit
Synopsis
quit [status]
Description
Stop Simics gracefully. The optional argument is the exit status of Simics.
Provided By
Simics Core
read-configuration
Synopsis
read-configuration file
Description
Read configuration from file. The configuration can be either a checkpoint or an initial configuration. For information about how to create or modify configurations, see the Simics User Guide.
Provided By
Simics Core
See Also
write-configuration
read-fp-reg-i
Synopsis
read-fp-reg-i reg-num
Description
SPARC V9 command. Prints a specific floating point register, as integer. This command supports the 32 single precision registers.
Provided By
sparc-niagara-turbo
read-fp-reg-x
Synopsis
read-fp-reg-x reg-num
Description
SPARC V9 command. Prints a specific floating point register, as integer. This command supports the 32 double precision registers.
Provided By
sparc-niagara-turbo
read-ipr
Synopsis
read-ipr [cpu-name] [(index|"name")]
write-ipr [cpu-name] (index|"name") value
Description
The Alpha microprocessor contains a file of internal processor registers (available only to privileged software through PALcode routines) that allow the operating system to interrogate and modify system state.

The read-ipr command reads the value of a single register. The register is specified either by its name (e.g. pal_base) or its index (e.g. 0x10E).

The write_ipr commands writes the given value to the specified register.

Note that register names and indices differs between different Alpha implementations (EV5, EV6, etc).

Provided By
alpha-ev5-turbo
read-reg
Synopsis
read-reg [cpu-name] "reg-name"
<processor>.read-reg "reg-name"
Description
This command reads a CPU register. For example, to read the eax register in an x86 processor called cpu0, write read-reg cpu0 eax. You can also use the method variant: cpu0.read-reg eax, or the more convenient variant %eax that reads a register from the selected frontend CPU.

If no cpu-name is supplied, the current frontend processor is used.

Provided By
Simics Core
See Also
%, write-reg, pregs, pselect
readme
Synopsis
readme
Description
Prints various useful information (README) about Simics.
Provided By
Simics Core
resolve-file
Alias
lookup-file
Synopsis
resolve-file "filename"
Description
Looks for the file filename in the Simics search path. If it is found, its complete path is returned.
Provided By
Simics Core
reverse
Alias
rev
Synopsis
reverse [count]
Description
Runs the simulation in reverse. The simulation will stop at any breakpoints or after at most count instructions (if specified).

Before the machine can be reversed, at least one time bookmark has to be set. Reverse operations are possible in the region following the first (oldest) time bookmark.

Provided By
rev-execution
See Also
set-bookmark, skip-to
reverse-next-instruction
Alias
rnexti, rni
Synopsis
reverse-next-instruction
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.finish-function, <context>.uncall-function
reverse-next-line
Alias
rnext, rn
Synopsis
reverse-next-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
reverse-step-instruction
Alias
ui, unstep-instruction, rstepi, rsi
Synopsis
reverse-step-instruction [count]
Description
Executes count instructions in reverse, printing each instruction at each step. count defaults to one.

The reverse-next-instruction command is similar except that it does not reverse into called functions.

Provided By
rev-execution
See Also
reverse-next-instruction, reverse-next-line, uncall-function, reverse-step-line
reverse-step-line
Alias
rstep, rs
Synopsis
reverse-step-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
reverse-to
Alias
revto
Synopsis
reverse-to ("bookmark"|instructions)
Description
Runs the simulation in reverse. The simulation will stop at any breakpoints or at the specified (absolute) point in time if no breakpoints occurred.

At least one time bookmark has to be set before any reverse operations are possible.

Provided By
rev-execution
See Also
set-bookmark
rexec-limit
Alias
rlimit
Synopsis
rexec-limit [size_mb] [steps]
Description
Tunes various overall resource limits for reverse execution which affect both forward and reverse performance.

size_mb limits the amount of memory used for reverse execution.

steps limits the scope of reversability to the specified number of steps.

Provided By
rev-execution
rse-status
Synopsis
rse-status [cpu-name]
Description
Displays the current status of the Register Stack Engine and its backing store.
Provided By
ia64-itanium
run
Alias
continue, c, r
Synopsis
run [count]
Description
Tells Simics to start or continue executing instructions. If a count argument is provided, Simics will execute count number of instructions and stop.
Provided By
Simics Core
See Also
step-instruction, run-cycles
run-command-file
Alias
include
Synopsis
run-command-file file
Description
This command starts executing a Simics script. A Simics script is an ordinary text file that contains Simics commands. One command on each line. The syntax used is exactly the same as when commands are typed at the Simics prompt. The # character is used as the start of a comment and applies to the rest of the line.

Python code can also by executed by prefixing the line with @. Multi-line Python statements can be used by leaving a blank line at the end of the statement. Only the first line should have an @ in this case.

Simics scripts usually ends with the suffix ".simics" but this is only a convention. The suffix is ignored by Simics.

This is an example of a Simics script:

# This is a Simics script

break 0xffc000 # set a breakpoint
run
echo "breakpoint reached"
run-command-file another-script.simics

Simics scripts can be executed directly when Simics has started by using the -x command line option.

If a command fails or the user presses Control-C the Simics script is interrupted and control returns to the Simics prompt.

run-command-file uses Simics's Search Path and path markers (%simics%, %script%) to find the script to run. Refer to Simics User Guide (CLI chapter) for more information.

Provided By
Simics Core
See Also
run-python-file, add-directory
run-cycles
Alias
continue-cycles, cc, rc
Synopsis
run-cycles [count]
Description
Tells Simics to start or continue executing instructions. If a count argument is provided, Simics will execute count number of cycles and stop. Note that running count cycles may or may not be equivalent to running count instructions depending on the way Simics is configured. Refer to the chapter Understanding Simics Timing in the Simics User Guide for more information.
Provided By
Simics Core
See Also
step-cycle, run
run-python-file
Alias
source
Synopsis
run-python-file filename
Description
Read Python code from filename. Any definitions are entered into the top level name-space in the Python environment. Uses the Simics search path to locate filename. This command can be used to start Python scripts inside Simics.
Provided By
Simics Core
See Also
python, @, run-command-file, add-directory
save-component-template
Synopsis
save-component-template file
Description
Save a configuration file with only component objects and their connection information. This template corresponds to an empty machine configuration, without any software setup. The saved component template can be loaded into Simics using the read-configuration command, producing a collection of non-instantiated components.
Provided By
Simics Core
See Also
read-configuration, write-configuration, list-components
save-persistent-state
Synopsis
save-persistent-state file [-z] [-u]
Description
Save the persistent simulator state to a file. Persistent data typically includes disk images, NVRAM and flash memory contents and clock settings, i.e. data that survive reboots. The persistent state is saved as a standard Simics configuration file.

Use the -z flag for compressed images, or -u for uncompressed. The default is taken from the preference object.

Provided By
Simics Core
See Also
load-persistent-state, write-configuration
script-branch
Synopsis
script-branch
Description
Starts a block of commands as a separate branch. The wait-for- commands can be used to postpone the execution of a script branch until a selection action occurs.
script-branch { commands }
Provided By
Simics Core
See Also
list-script-branches, interrupt-script-branch, wait-for-variable, wait-for-hap, <text-console>.wait-for-string, <processor>.wait-for-cycle, <processor>.wait-for-step
select-profiles
Synopsis
select-profiles [ profiler ... ]
Description
Specifies what profiles, if any, should be shown in subsequent source code listings, and in what order. Use without argument to show none.
Provided By
symtable
set
Synopsis
set address value [size] [-l] [-b]
<memory-space>.set address value [size] [-l] [-b]
Description
Set the size bytes of physical memory at location address to value. The default size is 4 bytes, but can be anywhere between 1 and 8 (inclusive).

If value is larger than the specified size, behavior is undefined.

The -l and -b flags are used to select little-endian and big-endian byte order, respectively. If neither is given, the byte order of the currently selected processor is used.

The non-namespace version of this command operates on the physical memory associated with the current processor.

Provided By
Simics Core
See Also
get, x, pselect
set-bookmark
Alias
bookmark, bo
Synopsis
set-bookmark ["bookmark"]
Description
Associates a time bookmark with the current point in the simulation. The bookmark can be used as a target to the skip-to command.

Reverse operations are possible in the region following the first (i.e. oldest) time bookmark.

Setting a time bookmark can cause a certain reduction in forward simulation performance (deleting all bookmarks will restore the original performance).

Provided By
rev-execution
See Also
delete-bookmark, reverse, skip-to
set-component-prefix
Synopsis
set-component-prefix "prefix"
Description
Sets a string prefix that will be added to the names of all component objects that are created after the invocation of this command.
Provided By
Simics Core
See Also
get-component-prefix
set-context
Synopsis
set-context "context"
<processor>.set-context "context"
Description
Sets the current context of the processor cpu (or the selected cpu) to context. If the context does not exist, it is created.
Provided By
Simics Core
See Also
new-context, <context>.symtable
set-memory-limit
Synopsis
set-memory-limit [limit] ["swapdir"]
Description
Limits the in-memory footprint of all image objects to limit megabytes. This only limits the memory consumed by image pages in memory. While this is typically a very large part of Simics's memory usage, other data structures are not limited by this command.

If limit is zero, the memory limit is removed. If swapdir is specified, it indicates a directory to use for swap files. If no argument is given, the current setting is displayed.

Simics sets a default memory limit at startup that depends on the amount of memory, and number of processors, on the host system.

Provided By
Simics Core
set-pattern
Synopsis
set-pattern id "pattern" "mask"
Description
When set for breakpoint id Simics will only break on instructions with a certain bit-pattern. First the mask will be applied to the instruction and then the result will be compared with the pattern. For example set-pattern 1 "0x0100" "0x0101" will specialize breakpoint 1 to break on instructions whose first byte has the lowest bit set and the second not.

Since an instruction may be longer than the longest supported integer in the frontend, both pattern and mask must be supplied as strings.

Set pattern and mask to the empty string ("") to remove this extra condition.

Provided By
Simics Core
Note
Only supported for execution breakpoints.
See Also
set-prefix, set-substr
set-pc
Synopsis
set-pc address
<processor>.set-pc address
Description
Set program counter (instruction pointer) of the CPU (defaults to the current frontend processor) to address.
Provided By
Simics Core
set-prefix
Synopsis
set-prefix id "prefix"
Description
Set a syntax prefix for a breakpoint. When set Simics will only break on instructions with a certain syntax prefix. For example set-prefix 1 "add" will cause breakpoint 1 only to stop if the instruction begins with "add". The text to compare the prefix with for an instruction is the one which the instruction is disassembled to.

Set prefix to the empty string ("") to remove this extra condition.

Provided By
Simics Core
Note
Only supported for execution breakpoints.
See Also
set-substr, set-pattern
set-simics-id — deprecated
Synopsis
set-simics-id id
Description
This command is deprecated, use the new central system instead.

Provided By
Simics Core
set-substr
Synopsis
set-substr id "substr"
Description
When set Simics will only break on instructions with a certain syntax substring. For example set-substr 1 "r31" will make breakpoint 1 only stop if the instruction has a substring "r31".

Set sub-string to the empty string ("") to remove this extra condition.

Provided By
Simics Core
Note
Only supported for execution breakpoints.
See Also
set-prefix, set-pattern
signed
Synopsis
signed int
signed16 int
signed32 int
signed64 int
signed8 int
Description
Interpret an integer, int, as a signed value of a specific bit width. For example signed16 0xffff will return -1. The signed command assumes a 64 bit width.
Provided By
Simics Core
signed16
Synopsis
signed16 int
signed int
signed32 int
signed64 int
signed8 int
Description
Interpret an integer, int, as a signed value of a specific bit width. For example signed16 0xffff will return -1. The signed command assumes a 64 bit width.
Provided By
Simics Core
signed32
Synopsis
signed32 int
signed int
signed16 int
signed64 int
signed8 int
Description
Interpret an integer, int, as a signed value of a specific bit width. For example signed16 0xffff will return -1. The signed command assumes a 64 bit width.
Provided By
Simics Core
signed64
Synopsis
signed64 int
signed int
signed16 int
signed32 int
signed8 int
Description
Interpret an integer, int, as a signed value of a specific bit width. For example signed16 0xffff will return -1. The signed command assumes a 64 bit width.
Provided By
Simics Core
signed8
Synopsis
signed8 int
signed int
signed16 int
signed32 int
signed64 int
Description
Interpret an integer, int, as a signed value of a specific bit width. For example signed16 0xffff will return -1. The signed command assumes a 64 bit width.
Provided By
Simics Core
simics-module-symbols
Synopsis
simics-module-symbols ["name"]
Description
Populate symbol table with symbols corresponding to the memory mappings.
Provided By
perfanalyze-client
skip-to
Alias
st
Synopsis
skip-to ("bookmark"|instructions)
Description
Skips to the specified point in time. The target position can either be a label previously defined by set-bookmark or an absolute instruction count.
Provided By
rev-execution
stack-trace
Alias
bt, where
Synopsis
stack-trace [maxdepth]
Description
Displays a stack trace in the current context of the specified processor, or the current processor if none was specified. At most maxdepth frames are shown, 64 by default.
Provided By
symtable
See Also
frame
start-logical-memory-translator
Synopsis
start-logical-memory-translator
Description
Create a logical memory translator and plug it to all cpus available in the system.
Provided By
logical-memory-translator
state-assertion-connect
Synopsis
state-assertion-connect ["server"] [port] ["compression"] [align] [post_events] ["name"]
Description
This command connects to a state-assertion receiver so that all data gathered during the state recording will be sent over to the receiver.
- server receiver host waiting for the connection
- port port number on which the receiver is waiting for a connection
- compression is the compression used (none, bz2, gz)
- name is the name of the object to be created. Default is saX where X is a number.
Provided By
state-assertion
state-assertion-create-file
Synopsis
state-assertion-create-file file ["compression"] ["name"] [align] [post_events]
Description
This command creates a state assertion file.
- file is the name of the file to be created
- compression is the compression used (none, bz2, gz)
- name is the name of the object to be created. Default is saX where X is a number. - align is the alignment of the structures inside the file. It can be useful to set it so that objects saving their state are sure to get correctly aligned structures. Default is 8 which is sufficient for most hosts. - post_events tells state-assertion to post events by itself for recording and comparing. Default is true.
Provided By
state-assertion
state-assertion-open-file
Synopsis
state-assertion-open-file file ["compression"] ["name"] [post_events]
Description
Open a state assertion file to compare it to the current execution.
- name is the name of the object. A default name in saX is provided if none is given.
- file is the name of the state assertion file
- compression is the compression used on the file (none, bz2, gz) - post_events
Provided By
state-assertion
state-assertion-receive
Synopsis
state-assertion-receive [port] ["compression"] ["name"] [post_events]
Description
Wait for a connection (state-assertion-connect) from a sender. The data received from the sender will be compared against the current execution.
- port indicates where simics should wait for the connection
- compression is the compression used on the file (none, bz2, gz) - name is the name of the object. A default name in saX is provided if none is given.
Provided By
state-assertion
state-assertion-simple-assert
Synopsis
state-assertion-simple-assert [file] ["compression"] [post_event]
Description
This command asserts the current run against the file. You just have to run 'c' afterwards to begin the assertion process.
Provided By
state-assertion
state-assertion-simple-record
Synopsis
state-assertion-simple-record ["file"] ["compression"] ["object-name"] [steps] [type]
Description
Create a file (by default /tmp/state-assertion-$USER.gz) and save the state of object every steps steps. You just have to run 'c' afterwards to begin the recording.
object is the simics object whose state will be recorded. steps is the number of steps between each state recording (default is 1).
Provided By
state-assertion
stc-status
Synopsis
stc-status
dstc-disable
dstc-enable
istc-disable
istc-enable
Description
These commands are for advanced users only. They allow the user to control the usage of Simics internal caches. The Simulator Translation Caches (STCs) are designed to increase execution performance. The D-STC caches data translations (logical to physical to real (host) address), while the I-STC caches instruction translations of taken jumps. By default the STCs are on. When a memory hierarchy is connected (such as a cache module) it must have been designed to work along with the STCs otherwise it may not be called for all the memory transactions it is interested in. These commands can be used to detect if too many translations are kept in the STCs, causing the simulation to be faulty. Turning the STCs off means that current contents will be flushed and no more entries will be inserted into the STCs.
Provided By
Simics Core
step-break
Alias
sb, sim-break
Synopsis
step-break [cpu-name] instructions
<processor>.step-break instructions
Description
Sets a breakpoint so that the CPU will stop after executing instructions number of steps from the time the command was issued. If the CPU is not specified the selected frontend processor will be used (see pselect).

To list all breakpoints set use the command list-breakpoints.

Provided By
Simics Core
See Also
step-break-absolute, cycle-break, cycle-break-absolute, list-breakpoints
step-break-absolute
Alias
sba, sim-break-absolute
Synopsis
step-break-absolute [cpu-name] instructions
<processor>.step-break-absolute instructions
Description
Set a breakpoint so that the selected CPU will stop after its step counter has reached the instructions value. If the CPU is not specified the selected frontend processor will be used (see pselect).

To list all breakpoints set use the command list-breakpoints.

Provided By
Simics Core
See Also
step-break-absolute, cycle-break, cycle-break-absolute, list-breakpoints
step-cycle
Alias
sc
Synopsis
step-cycle [count]
Description
Executes count cycles, printing the next instruction to be executed at each cycle. count defaults to one.
Provided By
Simics Core
See Also
step-cycle-single, run, step-instruction
step-cycle-single
Alias
scs
Synopsis
step-cycle-single [-n]
Description
Used with the Micro Architectural Interface only. step-cycle-single executes one cycle on the current processor, switches to the next processor and prints the next instruction to be committed. Repeated use will thus advance each processor in a round robin fashion. -n will prevent step-cycle-single from printing the next instruction after executing.
Provided By
Simics Core
See Also
step-cycle, step-instruction, run
step-instruction
Alias
si, stepi
Synopsis
step-instruction [count] [-r]
Description
Executes count instructions, printing the next instruction to be executed at each step. count defaults to one. With the -r flag, register changes will also be printed.
Provided By
Simics Core
See Also
run, step-cycle, step-cycle-single
step-line
Alias
step, s
Synopsis
step-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
stop
Synopsis
stop [-a] ["message"]
Description
Stop simulation as soon as possible. If the -a argument is give, any command script running will also be interrupted. A message to be printed on the console when the simulation stops can also be specified.
Provided By
Simics Core
See Also
run
sum — deprecated
Synopsis
sum [cpu-name] address size [-w8] [-w16] [-w32]
<processor>.sum address size [-w8] [-w16] [-w32]
Description
This command is deprecated, use python instead.

Sum a memory range. The width of the running sum is specified with the -w8 (default), -w16, or -w32 flag, standing for 8, 16, and 32 bits respectively.

Provided By
Simics Core
symval
Alias
sym
Synopsis
symval "expression"
Description
Evaluates expression in the current stack frame. The only C operators allowed are casts, indirection, member selection, and sizeof (thus no arithmetic). You may need to surround the expression by double quotes if it contains certain meta-characters. In contrast to psym, the result is returned as an unadorned value that can be used in CLI expressions.
Provided By
symtable
See Also
stack-trace, frame, psym
tcpdump
Synopsis
tcpdump [link] [device] ["tcpdump-flags"]
Description
Runs the tcpdump program in a separate console, with network traffic captured from simulated ethernet networks. The tcpdump-flags are passed on unmodified to tcpdump.
Provided By
ethernet-link
tlb-status
Synopsis
tlb-status [cpu-name]
Description
Displays the current status of the two TLBs.
Provided By
ia64-itanium
trace-breakpoint
Synopsis
trace-breakpoint ("breakpoint"|-all|-list)
untrace-breakpoint ("breakpoint"|-all|-list)
Description
Enables and disables tracing of breakpoints. When enabled, breakpoint hits will be traced to the console instead of stopping the simulation.

The id parameter specifies the breakpoint to trace.

Instead of an id, the -all flag may be given. This will enable or disable tracing of all breakpoints.

Provided By
Simics Core
trace-cr
Synopsis
trace-cr ("register"|-all|-list)
<processor>.trace-cr ("register"|-all|-list)
<processor>.untrace-cr ("register"|-all|-list)
untrace-cr ("register"|-all|-list)
Description
Enables and disables tracing of control register updates. When this is enabled, every time the specified control register is updated during simulation a message is printed. The message will name the register being updated, and the new value. The new value will be printed even if it is identical to the previous value.

The reg-name parameter specifies which control register should be traced. The available control registers depends on the simulated target.

Instead of a register name, the -all flag may be given. This will enable or disable tracing of all control register.

Provided By
Simics Core
See Also
break-cr
trace-exception
Synopsis
trace-exception (number|"name"|-all|-list)
untrace-exception (number|"name"|-all|-list)
Description
Enables and disables tracing of exceptions. When this is enabled, every time the specified exception occurs during simulation a message is printed.

The exception parameter specifies which exception should be traced. The available exceptions depends on the simulated target.

Instead of an exception, the -all flag may be given. This will enable or disable tracing of all exceptions.

Provided By
Simics Core
See Also
break-exception
trace-hap
Synopsis
trace-hap ("hap"|-all|-list)
untrace-hap ("hap"|-all|-list)
Description
Enables and disables tracing of haps. When this is enabled, every time the specified hap is triggered a message is printed.

The hap parameter specifies the hap.

Instead of a hap, the -all flag may be given. This will enable or disable tracing of all haps.

Provided By
Simics Core
See Also
break-hap, list-haps
trace-io
Synopsis
trace-io ("device"|-all|-list)
untrace-io ("device"|-all|-list)
Description
Enables and disables tracing of device accesses. When this is enabled, every time the specified device is accessed during simulation a message is printed.

The device parameter specifies the device object that should be traced.

Instead of an object name, the -all flag may be given. This will enable or disable tracing of all devices.

Provided By
Simics Core
See Also
break-io
trap-info
Synopsis
trap-info
Description
Print information about current traps. This includes info such as trap type, time of trap, and source reference to trap PC for all trap levels.
Provided By
sparc-niagara-turbo
unbreak
Synopsis
unbreak (id|-all) address length [-r] [-w] [-x]
Description
Removes an address range from a breakpoint, splitting the breakpoint if necessary. -r (read), -w (write) and -x (execute) specify the type of breakpoint that should be removed in the given address range. It defaults to execute if no flag is given. id is the id number of the breakpoint to operate on. To operate on all breakpoints at once, use the -all flag. list-breakpoints prints all breakpoints' id.
Provided By
Simics Core
See Also
<breakpoint>.break, delete
unbreak-cr
Synopsis
unbreak-cr ("register"|-all|-list)
<processor>.break-cr ("register"|-all|-list)
<processor>.unbreak-cr ("register"|-all|-list)
break-cr ("register"|-all|-list)
Description
Enables and disables breaking simulation on control register updates. When this is enabled, every time the specified control register is updated during simulation a message is printed. The message will name the register being updated, and the new value. The new value will be printed even if it is identical to the previous value.

The reg-name parameter specifies which control register should be traced. The available control registers depends on the simulated target.

Instead of a register name, the -all flag may be given. This will enable or disable tracing of all control register.

Provided By
Simics Core
See Also
trace-cr, <breakpoint>.break
unbreak-exception
Synopsis
unbreak-exception (number|"name"|-all|-list)
break-exception (number|"name"|-all|-list)
Description
Enables and disables breaking simulation on exceptions. When this is enabled, every time the specified exception occurs uring simulation a message is printed.

The exception parameter specifies which exception should be traced. The available exceptions depends on the simulated target.

Instead of an exception, the -all flag may be given. This will enable or disable tracing of all exceptions.

Provided By
Simics Core
See Also
trace-exception, <breakpoint>.break
unbreak-hap
Synopsis
unbreak-hap ("hap"|-all|-list)
break-hap ("hap"|-all|-list)
Description
Enables and disables breaking simulation on haps. When this is enabled, every time the specified hap is triggered a message is printed and simulation is stopped.

The hap parameter specifies the hap.

Instead of a hap, the -all flag may be given. This will enable or disable breaking on all haps.

Provided By
Simics Core
See Also
trace-hap, list-haps
unbreak-io
Synopsis
unbreak-io ("device"|-all|-list)
break-io ("device"|-all|-list)
Description
Enables and disables breaking simulation on device accesses. When this is enabled, every time the specified device is accessed during simulation a message is printed and the simulation stops.

The device parameter specifies which device object should be traced.

Instead of an object name, the -all flag may be given. This will enable or disable breaking on accesses to all device.

Provided By
Simics Core
See Also
trace-io, <breakpoint>.break
uncall-function
Alias
uncall
Synopsis
uncall-function
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

Provided By
Simics Core
See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function
undisplay
Synopsis
undisplay expression-id
Description
Remove a Python expression, or a frontend statement that was previously installed with the display command. The argument is the id number of the expression, as listed by display -l.
Provided By
Simics Core
See Also
display
unload-module
Synopsis
unload-module "module"
Description
Unload a module (Simics extension). Note that not all modules can be unloaded.
Provided By
Simics Core
See Also
load-module
unset
Synopsis
unset [-a] [ "variables" ... ]
Description
Removes (unsets) a Simics environment variable. The -a flag causes all variables to be removed, except the ones specified as variables.
Provided By
Simics Core
untrace-breakpoint
Synopsis
untrace-breakpoint ("breakpoint"|-all|-list)
trace-breakpoint ("breakpoint"|-all|-list)
Description
Enables and disables tracing of breakpoints. When enabled, breakpoint hits will be traced to the console instead of stopping the simulation.

The id parameter specifies the breakpoint to trace.

Instead of an id, the -all flag may be given. This will enable or disable tracing of all breakpoints.

Provided By
Simics Core
untrace-cr
Synopsis
untrace-cr ("register"|-all|-list)
<processor>.trace-cr ("register"|-all|-list)
<processor>.untrace-cr ("register"|-all|-list)
trace-cr ("register"|-all|-list)
Description
Enables and disables tracing of control register updates. When this is enabled, every time the specified control register is updated during simulation a message is printed. The message will name the register being updated, and the new value. The new value will be printed even if it is identical to the previous value.

The reg-name parameter specifies which control register should be traced. The available control registers depends on the simulated target.

Instead of a register name, the -all flag may be given. This will enable or disable tracing of all control register.

Provided By
Simics Core
See Also
break-cr
untrace-exception
Synopsis
untrace-exception (number|"name"|-all|-list)
trace-exception (number|"name"|-all|-list)
Description
Enables and disables tracing of exceptions. When this is enabled, every time the specified exception occurs during simulation a message is printed.

The exception parameter specifies which exception should be traced. The available exceptions depends on the simulated target.

Instead of an exception, the -all flag may be given. This will enable or disable tracing of all exceptions.

Provided By
Simics Core
See Also
break-exception
untrace-hap
Synopsis
untrace-hap ("hap"|-all|-list)
trace-hap ("hap"|-all|-list)
Description
Enables and disables tracing of haps. When this is enabled, every time the specified hap is triggered a message is printed.

The hap parameter specifies the hap.

Instead of a hap, the -all flag may be given. This will enable or disable tracing of all haps.

Provided By
Simics Core
See Also
break-hap, list-haps
untrace-io
Synopsis
untrace-io ("device"|-all|-list)
trace-io ("device"|-all|-list)
Description
Enables and disables tracing of device accesses. When this is enabled, every time the specified device is accessed during simulation a message is printed.

The device parameter specifies the device object that should be traced.

Instead of an object name, the -all flag may be given. This will enable or disable tracing of all devices.

Provided By
Simics Core
See Also
break-io
up
Synopsis
up [N]
Description
Moves N frames up the stack (towards the outermost frame). N defaults to one.
Provided By
symtable
See Also
frame, down, stack-trace
v9-sol9-idle-opt
Synopsis
v9-sol9-idle-opt memory-space [-multi-pro]
Description
Adds idle loop optimization to a simulated SPARC machine running Solaris 9. The memory_space argument must specify the physical memory space of the simulated machine. The -multi-pro flag must be specified for simulated multi-pro machines.
Provided By
v9-sol9-idle-opt
version
Synopsis
version [-v]
Description
Prints the Simics version. With the -v flag, compiler version and compile dates are printed as well.
Provided By
Simics Core
wait-for-hap
Synopsis
wait-for-hap "hap" [object] [idx0] [idx1] ["ret"]
Description
Postpones execution of a script branch until hap occurs. The optional argument obj limits the haps to a specific object, and idx0, idx1 can be used for indexed and range haps. The data associated with the hap can be saved into the named variable specified by ret. This variable will be indexed, with local scope.
Provided By
Simics Core
See Also
script-branch, wait-for-variable, <text-console>.wait-for-string, <processor>.wait-for-cycle, <processor>.wait-for-step
wait-for-variable
Synopsis
wait-for-variable "variable"
Description
Postpones execution of a script branch until a CLI variable is written by some other script branch or the main thread.
Provided By
Simics Core
See Also
script-branch, wait-for-hap, <text-console>.wait-for-string, <processor>.wait-for-cycle, <processor>.wait-for-step
whereis
Synopsis
whereis [-d] address
Description
Displays the function or variable and (if possible) the source file and line number corresponding to address. If -d is specified, searches only data symbols. Does not look for stack-allocated variables.
Provided By
symtable
See Also
pos, psym
while
Synopsis
while
Description
Runs a block of commands while condition is true.
while <condition> { commands }
Provided By
Simics Core
See Also
if
write-configuration
Synopsis
write-configuration file [-z] [-u]
Description
Write configuration to disk. In addition to the main text configuration file, objects may create additional files with names starting with file. Note that some classes save their state incrementally meaning that files from earlier checkpoints (or from the starting configuration) may be referenced in the new checkpoint.

Use the -z flag for compressed images, or -u for uncompressed. The default is taken from the preference object.

Provided By
Simics Core
See Also
read-configuration, save-persistent-state
write-fp-reg-i
Synopsis
write-fp-reg-i reg-num value
Description
SPARC V9 command. Writes floating point register (as integer).
Allows you to selectively modify a floating point register. Note: takes new value in 32 bit integer format.
Provided By
sparc-niagara-turbo
write-fp-reg-x
Synopsis
write-fp-reg-x reg-num value
Description
SPARC V9 command. Writes floating point register (as 64 bit integer).
Allows you to selectively modify a floating point register.
Note: takes new value in 64 bit integer format.
Provided By
sparc-niagara-turbo
write-ipr
Synopsis
write-ipr [cpu-name] (index|"name") value
read-ipr [cpu-name] [(index|"name")]
Description
The Alpha microprocessor contains a file of internal processor registers (available only to privileged software through PALcode routines) that allow the operating system to interrogate and modify system state.

The read-ipr command reads the value of a single register. The register is specified either by its name (e.g. pal_base) or its index (e.g. 0x10E).

The write_ipr commands writes the given value to the specified register.

Note that register names and indices differs between different Alpha implementations (EV5, EV6, etc).

Provided By
alpha-ev5-turbo
write-reg
Synopsis
write-reg [cpu-name] "reg-name" value
<processor>.write-reg "reg-name" value
Description
Use this command to set the value of a CPU register. For example, to set the eax register on the x86 processor cpu0 to 3, write write-reg cpu0 eax 3. You can also use the method variant: cpu0.write-reg eax 3.

This function may or may not have the correct side-effects, depending on target and register. If no cpu-name is given, the current frontend processor is used.

Provided By
Simics Core
See Also
%, read-reg, pregs, pselect
x
Synopsis
x [cpu-name] address [size]
<memory-space>.x address [size]
<processor>.x address [size]
Description
Display the contents of a memory space starting at address. Either the memory space is explicitly specified as in <memory-space>.x or the CPU connected to the memory space can be specified; e.g., <processor>.x. By itself, x operates on the memory connected to the current frontend processor.

If the memory is accessed via a CPU, the type of address is specified by a prefix. For physical addresses use p:address; for virtual addresses, v:address on non-x86 targets. On x86, use segment-register:offset or l:address for x86 linear addresses.

If no prefix is given it will be interpreted as a virtual address. On x86 the default is ds:address (data segment addressing).

The size argument specifies the number of bytes to examine. When examining virtual memory, only addresses which can be found in the TLB or hardware page tables (if any) are shown. Unmapped addresses are shown as "--", undefined physical addresses as "**".

Provided By
Simics Core
See Also
disassemble, get, set
~
Synopsis
~ arg1
Description
Bitwise not.
Provided By
Simics Core

VIRTUTECH CONFIDENTIAL    Previous - Up - Next