Section: PARSEC Benchmark Suite (5)
Updated: December 2008
Return to Main Contents
runconf - Format of a PARSEC run configuration
A run configuration is a set of configuration files of the PARSEC framework
that describe how to execute a benchmark program. It encapsulates all
information about the details of program invocation and make it accessible
to the framework in a standardized way.
Run configurations have special significance with regard to benchmarking as
they standardize program execution in a way that is easily comparable. Any
modifications of a run configuration should therefore be reported together
with the results obtained with it.
All run configuration files are executable bash scripts, which means
that a large degree of freedom exists for writing these configurations. The
scripts must set a number of predefined configuration variables as described
Run configurations expect that the environment variable NTHREADS contains
the number of threads to use.
A run configuration is usually defined for all workloads of the benchmark suite
and is composed of a global and a local part. The global part defines the
properties that apply to all benchmarks, whereas a local part only applies to
the package it belongs to.
GLOBAL CONFIGURATION VARIABLES
The global part of a run configuration has to define the following variables:
A string giving a brief description of the run configuration. This variable
does not affect program execution, it merely exists for information purposes.
LOCAL CONFIGURATION VARIABLES
A run configuration must define the following variables for each executable
The executable to run. The path must be relative to the installation directory
of the package.
The full set of arguments to pass to the binary.
Not every package must have a local run configuration. A package which does
not have a run configuration is interpreted as not executable by the PARSEC
All files belonging to a run configuration have the same name but are located
in different directories. The name of the files is formed by appending the
ending .runconf to the name of the run configuration.
Global run configuration files are located in the config/ directory of
the PARSEC installation root.
Local run configuration files are located in the parsec/ directory of
the package they belong to.
Environment variable containing the number of threads to use. The value is
passed to the program to execute, which interprets it according to its
own semantics. The actual number of threads might vary.
Written by Christian Bienia.
Copyright (c) 2006-2009 Princeton University
- CONFIGURATION VARIABLES
- GLOBAL CONFIGURATION VARIABLES
- LOCAL CONFIGURATION VARIABLES
- SEE ALSO
This document was created by
using the manual pages.
Time: 04:41:54 GMT, February 24, 2009