This program provides a way to generate synthetic performance data for testing
and debugging the rest of the paradyn system.
It is provides the same dynamic instrumentation interface
provided by other paradyn daemons.
However rather than running a parallel program, it reads a file
(<description File>) that describes a synthetic "program".
The description file describes the metrics and foci available for the "program".
In addition, it describes how to generate a metric for each focus.
paradyndSIM then "runs" this "program" and processes requests to enable and
disable data collection for the "program".
<log file>.
This is useful for debugging "program" description files and paradyndSIM
itself.
This is considered an option to the synthetic program, and must appear
after the <description File> on the command line.
<description File> on the command line.
The basic format of the description file is:
duration <float>
rate <float>
seed <float>
# anything from a `#' to the end of a line is a comment
<metrics declarations>
<data source declarations>
<focus declarations>
<metric focus pairs>
The first section defines three global variables.
The duration variable indicates the length of the program's execution
in seconds.
The rate variables defines the time between samples in seconds.
A value of 1.0 indicates that samples should be generated once a second.
seed defines the seed value for the random number generator
used to create the data.
By setting this value, paradyndSIM will generate the same data every-time
a particular program is run.
The default value of the seed is pseudo-random based on pid and time of day.The second section of a program description declares the metrics. A metric declaration looks like:
\fCmetric metricName units [eventMetric | sampleMetric]The third part of a program definition is the data sources. Data sources are time varying functions that can be used to describe the value of a metric/focus pair. The syntax of a source declaration looks like:
\fCsource cpuSrc = srcExpr;
min to max
and has its value repeats every period seconds.
The duty cycle of the wave is duty cycle.
(The duty cycle of a square wave is the fraction of the period where the
value is max).
The value of the function starts and max at time 0 and remains there
for the first duty cycle * period seconds.
min and max.
focus focus name = <resource name, resource name, ...>;
The final component of a program description is a series of metric/resource
pairs and how to calculate the value of each pair.
The basic form of a definition is:
\fImetricName\fC<focusName> = srcExpr;
This document was translated by ms2html v1.7 on 16.02.94. OMN