B.J. Overeinder 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.

Command Line Usage


-a address
Specify a pearl info address.
Pearl info flag.
Trace flag
No skip flag
Enable spy points
Throughput flag
No state flag
-i title
Specify visualization window title.
-k expression
Specify skip expression.
Enable coredump on fatal errors.
Verbose topology.
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.
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)

See Also

ymlpearl(1), SESAMERunner(1), ymlpp(1), PNRunner(1), http://sesamesim.sourceforge.net/