.TH simulate 1 "Sept 18, 2007" "" "SAM system simulator"
simulate - run SAM with a particular system configuration
Simulate is a wizard script that is used to run SAM
with a SAM configuration (rc-file) that was generated
on the fly. The script generates the file sam.rc.
After generating the file it invokes sam -c sam.rc
The simulate wizard expects that the collection of binaries
needed to run RUST or Solaris is present in the current
working directory. Simulate expects a known collection
of filenames to be present there. Use the getrust(1) and
getsolaris(1) wizards to get a working starting set of files.
Simulate is best used in conjunction with the getrust(1)
and getsolaris(1) wizards. The get wizards getrust(1)
and getsolaris(1) create a directory outside the current
working directory. Change directory into that created
directory and invoke the simulate wizard there.
The simulate wizard is not a one for all solution. The
sam.rc file that it generates can always be taken and
modified for a special need. After the modification,
invoke SAM directly: sam -c modifiedsam.rc, see sam(1).
and create a sam.rc file that resembles a system for this
can be one of: n2, depending on the SAM release
= 1c1t 1up 1c2t 1g2p 1g4p 1g16p 1g32p 8c8t ...
The configuration is a machine description. Usually for
Solaris and RUST you will find
files. simulate will err and exit if it can't find the
The number of workers (worker-threads) to create. A number >1 causes
the simulator to run MP on MP if a configuration with more
Boot Solaris. See getsolaris(1) on how to get Solaris binaries.
The -s option cannot be used in conjunction with the
Run RUST. See getrust(1) on how to get RUST binaries.
The -r option cannot be used in conjunction with the
Run a diag. The -d option cannot be used in conjunction
with the -s, -r, or -R options.
Auto boot OBP followed by Solaris or RUST. This option
causes the file nvram1-auto to be loaded instead of the
file nvram1. In non autoboot mode, the user is expected to know
what to type at the OBP ok prompt. For solaris this
, for RUST this usually is
The -a option is only compatible with -r or -s.
Verbose boot Solaris. This option uses a Solaris
disk image (disk1.verbose) that has a modified
/etc/system file. The line
.I set moddebug=0x80000000
was added. The -v option is only compatible with -s.
This option is for including extra rc files in the generated
sam.rc file. This is useful for example to extend say a bare bone
N2 system (Huron) with devices connected to the pcie bus.
This option is for advanced users that want to modify the
system setup. The default system setup
is the same as provided with the -p option)
is in the etc directory of the release.
Start SAM from a dump that is in
A dump is generated at the SAM prompt with the
The -R option cannot be used in conjunction with the
argument can be of the form
which means load binary file
If there is no comma character in the
argument, or image has a trailing comma, then
is a file that is expected to be in the cpu and system
verilog memory image format. This file-format is usually
produced by the Midas tool. For the -s and -r option the
files are loaded after the standard set of files that are loaded
The -L can be used to override memory with user specific
The simulate wizard accepts multiple -L options. The
files are loaded into memory in the order they appear on
This option is for advanced users that want to tightly control
the system setup. The -D option passes
on to the m4 tool that preprocesses the system rc file before it
is added to sam.rc. A common
which disables popping the xterm when used in conjunction with
.BI -V " veracity-script"
as an argument. simulate will create a veracity script to start up
RUST or Solaris, depending on whether
is present. The start-up script will be called
respectively which can be included by
to perform standard initialization.
flag, this runs veracity in batch mode, directing all serial console
Run SAM UI commands from file <cmd_file> before returning to UI prompt.
Turn on output logging to file <log_file>.
The example processor here is n2. The available processor depend
Run Solaris on one strand, autoboot, and in verbose mode.
.B "simulate -p n2 -c 1c1t -s -a -v"
Run Solaris on two strands, autoboot and use two workers.
.B "simulate -p n2 -c 1c2t -w2 -s -a"
Run RUST on one strand, autoboot.
.B "simulate -p n2 -c 1c1t -r -a"
Run RUST on two strands, autoboot and use two workers.
.B "simulate -p n2 -c 1c2t -w 2 -r -a"
Run Solaris on one strand, loading one extra binary file into memory.
.B "simulate -pn2 -c1c1t -sa -Lmyreset.bin,0xff0000000"
Run a diag on one strand, loading one verilog memory image file into memory.
.B "simulate -pn2 -c1c1t -d -Lmem.image"
Run Solaris and do not pop up the console xterms
.B "simulate -pn2 -c1c2t -w2 -sa -Dpop="
The config -c option in combination with -s or -r option is at the
mercy of the available machine description files.
Wizard and manual page by SUN