PARSECMGMT

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

NAME

parsecmgmt - The PARSEC Management Tool  

SYNOPSIS

parsecmgmt -a ACTION [OPTION]...  

DESCRIPTION

parsecmgmt allows PARSEC users to manage their benchmark suite distribution. It can be used to build and run benchmark programs. parsecmgmt also provides mechanisms to obtain general information about the available features as well as query the current status of the suite.

It is not necessary to use parsecmgmt to work with PARSEC, all actions can also be performed manually. The tool executes the following steps to build a package:

1.
Set variable PARSECDIR to the installation root of PARSEC.
2.
Set variable PARSECPLAT to the platform descriptor string used to identify the current platform.
3.
Source system configuration.
4.
Source global build configuration.
5.
Source local build configuration.
6.
Create the build directory and change to it.
7.
Modify build environment and call configure script (if it exists).
8.
Modify build environment and execute make.
9.
Modify build environment and execute make install.

The following steps are executed to run a benchmark:

1.
Set variable PARSECDIR to the installation root of PARSEC.
2.
Set variable PARSECPLAT to the platform descriptor string used to identify the current platform.
3.
Source system configuration.
4.
Source global run configuration.
5.
Source local run configuration.
6.
Create run directory and change to it.
7.
Unpack desired input files into run directory (if they exist).
8.
Execute benchmark with command line arguments from run configuration.
 

OPTIONS

-a ACTION
Specifies the action to perform. See below for a list of valid actions.
-p PACKAGE
A list of packages or aliases on which the action is to be performed. A list of all available packages and their groups can be obtained with the info action.
-c CONFIG
Which build configuration to use. A list of all available build configurations can be obtained with the info action. Default is gcc.
-d RUNDIR
Use directory RUNDIR as root in which to run the benchmarks. Default is the installation root of the PARSEC distribution.
-i INPUT
The input set to use to run the benchmarks. A list of all available input sets can be obtained with the info action. Default is test.
-n THREADS
The minimum number of threads to use. Default is 1.
-s SUBMIT
Command to use to submit the benchmark for execution. Default is time.
-x EXTENSION
Extension to append to the platform descriptor string stored in the environment variable PARSECPLAT. Extensions allow to build and use multiple binaries of the same type. Default is none.
-h
Displays a help message.
 

ACTIONS

Every time parsecmgmt is used one of several actions has to be specified. Possible choices are:
build
Builds and installs the specified packages.
run
Runs the specified packages.
clean
Removes all files generated during the build and run phase of the listed packages for the current platform, but leaves the installed files untouched.
uninstall
Removes the installed files of the given packages for the current platform.
fullclean
Like clean but for all platforms.
fulluninstall
Like uninstall but for all platforms.
status
Shows a summary of the current status of the PARSEC distribution.
info
List available packages and configurations.
 

EXAMPLES

Build the complete suite:

parsecmgmt -a build -p all

Build only applications, use icc as build configuration:

parsecmgmt -a build -c icc -p apps

Do a full cleanup after a build or benchmark run:

parsecmgmt -a fullclean -p all

Remove all generated files of the current architecture:

parsecmgmt -a uninstall -p all

Run benchmark 'ferret' with input 'simsmall' and 4 threads:

parsecmgmt -a run -i simsmall -n 4

Get a quick summary of all available packages and features:

parsecmgmt -a info

Show which kernel binaries have been installed:

parsecmgmt -a status -p kernels

 

FILES

.parsec_uniquefile
Hidden dummy file used by parsecmgmt to recognize that the correct directory has been auto-detected.
 

ENVIRONMENT

PARSECDIR
Path to the root directory of the PARSEC distribution. parsecmgmt auto-detects the root directory by using heuristics to search for .parsec-uniquefile, but it is possible to override that behavior with this environment variable.
PARSECPLAT
Unique identifier for the current machine type. The value of this variable is used to separate the build and installation directories for different machine types so they can coexist in a single PARSEC distribution directory. parsecmgmt automatically determines a value based on the OS and CPU names, but it is possible to override the default value with this environment variable.
 

AUTHOR

Written by Christian Bienia.  

COPYRIGHT

Copyright (c) 2006-2009 Princeton University  

SEE ALSO

parsec(7), bldconfadd(1), bldconfdel(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ACTIONS
EXAMPLES
FILES
ENVIRONMENT
AUTHOR
COPYRIGHT
SEE ALSO

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