J.G. Stil
05 April 2006
Version 1.5.0
ymlpearlexec
Runs an instance of a ymlpearl architecture application.
Table of Contents
ymlpearlexec
[OPTIONS]
architecture.yml
ymlpearlexec
is part of the SESAME software system. More information
can be found on the web at http://sesamesim.sourceforge.net/.
The manual page describes the interface to compiled ymlpearl architecture
simulations. THE ACTUAL EXECUTABLE WILL PROBABLY NOT BE NAMED ymlpearlexec.
The name depends on the how the simulator instance was built.
In order to run a Pearl simulation you need to supply a YML mapping
file and either trace files or a mapping key from a running application
simulation via the -m key
option.
The following examples demonstrate
this usage. The first example uses traces files named
trace0, trace1,. . ., traceN
where N is the total number of trace files minus
one. The second example uses a shared memory mapping to cosimulate
with a running application. The architecture simulation executable is
assumed to be named architecture.
architecture -T trace
architecture -S -K 12345 -m map.yml
In the second example above, 12345 should be replaced with the actual
mapping key provided by the application simulator.
Pearl simulations can produce a large number of statistics via the
-p file
option. If file
is '-' then these statistics
will be printed to standard out, otherwise they will be written to
file.
- -a address
- Specify a pearl info address.
- -I
- Pearl info flag.
- -t
- Trace flag
- -n
- No skip flag
- -s
- Enable spy points
- -h
- Throughput flag
- -o
- No state flag
- -i title
- Specify visualization window title.
- -k expression
- Specify skip expression.
- -c
- Enable coredump on fatal errors.
- -v
- Verbose topology.
- -q
- Suppress interpreter output. (except errors)
- -m mapping.yml
- Used the specified YML mapping for trace output.
- -K key
- Used the specified mapping key. If this parameter is
not given and -m is used you will be prompted for the key
at runtime.
- -S
- Used the shared memory mapping interface instead of the default
message queue implementation.
- .yml files
- Architecture simulation description files describe the structure
of a simulation. Any architecture component compiled into the
executable may be used in the simulation. The YML file format
is described in detail in the
YML Users Guide.
YML usage
specific to ymlpearlexec
is described in the
YMLPearl Users Guide.
To load and execute a simulation described in simulation.yml run the following.
ymlpearlexec simulation.yml
Get traces using the specified mapping and mapping key.
ymlpearlexec -m simmap.yml -K 1234 simulation.yml
B.J. Overeinder (pearl compiler)
J.G. Stil (pearl compiler)
Andy Pimentel andy@science.uva.nl
(various improvements)
Frank Terpstra ftrpstra@science.uva.nl
(yml interface)
Joseph Coffland jcofflan@users.sourceforge.net
(yml interface, frontend, docs)
ymlpearl(1),
SESAMERunner(1),
ymlpp(1),
PNRunner(1),
http://sesamesim.sourceforge.net/
|