[ Bristol CS | Index | Research | Predictable Caching ]

Introduction

Building large scripts for the performance farmer is a thankless task. When the number of cache configurations to sours into the thousands things get hard to manager by hand. The script generator semi-automates the process of generating script files by filling in the hard to manage cache section for you, leaving only the process and machine names to add.

Operating The Script Generator

Installing The Script Generator

The script generator is written in Java and so to use it you must have a recent version of the Java runtime system installed. Once this is achieved, you should be able to sucessfully issue the following command : machine% java -version java version "1.1.3" Having installed a Java runtime system, you should set up your CLASSPATH environment variable to point at the installation JAR file containing the performance farmer system : machine% CLASSPATH=$CLASSPATH:performance.jar From now on you should be able to run the script generator by issuing commands as discussed below : machine% java performance.ScriptGenerator -outputNWaySetAssociativeCache

Customizing The Script Generator Behaviour

The behaviour of the script generator is changed by the use of the command line options shown below :

Switch	Default Value	Resulting Behaviour
		Specify a file from which the command line arguments should be read. This file takes the form of a standard Java properties file and is useful where the command line is very long or needs to be reused in some way.
		Specify a file to read from instead of standard input.
		Specify a file to write to instead of standard output.
		Process and output the information needed to simulate a sweep of PartitionedCache caches.
		Process and output the information needed to simulate a sweep of HenksPartitionedCache caches.
		Process and output the information needed to simulate a sweep of NWaySetAssociative caches.
		Process and output the information needed to simulate a sweep of VictimCache caches.
		Print the help screen.

Dan Page, page@cs.bris.ac.uk,

James Irwin, jimbob@cs.bris.ac.uk,

Henk Muller, Henk.Muller@bristol.ac.uk,