RUNCONF

Section: PARSEC Benchmark Suite (5)
Updated: December 2008
Index Return to Main Contents
 

NAME

runconf - Format of a PARSEC run configuration  

DESCRIPTION

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 below.  

PREREQUISITES

Run configurations expect that the environment variable NTHREADS contains the number of threads to use.  

CONFIGURATION VARIABLES

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:
run_desc
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 package:
run_exec
The executable to run. The path must be relative to the installation directory of the package.
run_args
The full set of arguments to pass to the binary.
 

NOTE

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 framework.  

FILES

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.
config/*.runconf
Global run configuration files are located in the config/ directory of the PARSEC installation root.
pkgs/*/*/parsec/*.runconf
Local run configuration files are located in the parsec/ directory of the package they belong to.
 

ENVIRONMENT

NTHREADS
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.
 

AUTHOR

Written by Christian Bienia.  

COPYRIGHT

Copyright (c) 2006-2009 Princeton University  

SEE ALSO

parsec(7), parsec.conf(5), sysconf(5), bldconf(5), parsecmgmt(1), bash(1)


 

Index

NAME
DESCRIPTION
PREREQUISITES
CONFIGURATION VARIABLES
GLOBAL CONFIGURATION VARIABLES
LOCAL CONFIGURATION VARIABLES
NOTE
FILES
ENVIRONMENT
AUTHOR
COPYRIGHT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 04:41:54 GMT, February 24, 2009