WARNING! Access to this system is limited to authorised users only.
Unauthorised users may be subject to prosecution.
Unauthorised access to this system is a criminal offence under Australian law (Federal Crimes Act 1914 Part VIA)
It is a criminal offence to:
(1) Obtain access to data without authority. -Penalty 2 years imprisonment.
(2) Damage, delete, alter or insert data without authority. -Penalty 10 years imprisonment.
User activity is monitored and recorded. Anyone using this system expressly consents to such monitoring and recording.

To protect your data, the CISO officer has suggested users to enable 2FA as soon as possible.
Currently 2.7% of users enabled 2FA.

Commit 5d4c7e45 authored by Steve Blackburn's avatar Steve Blackburn
Browse files

Moved README

parent 053f315f
The DaCapo Benchmark Suite
--------------------------
# The DaCapo Benchmark Suite
Last updated 2009-12-18
......@@ -8,109 +7,80 @@ It consists of a set of open source, real world applications with
non-trivial memory loads.
Guidelines for use
------------------
## Guidelines for use
When quoting results in publications, the authors of this suite
strongly request that:
- The exact version of the suite be given (number & name)
* The exact version of the suite be given (number & name)
- The suite be cited in accordance with the usual standards of
acknowledging credit in academic research.
* The suite be cited in accordance with the usual standards of acknowledging credit in academic research.
Please cite the 2006 OOPSLA paper (http://doi.acm.org/10.1145/1167473.1167488)
* Please cite the [2006 OOPSLA paper](http://doi.acm.org/10.1145/1167473.1167488)
- All command line options used be reported. For example, if you
explicitly override the number of threads or set the number of
iterations, you must report this when you publish results.
* All command line options used be reported. For example, if you explicitly override the number of threads or set the number of iterations, you must report this when you publish results.
For more information see the Dacapo Benchmark web page,
For more information see the [DaCapo Benchmark web page](http://dacapobench.org).
http://dacapobench.org
## Building
Building
--------
The easiest way to obtain the benchmark suite is to download the
pre-built jar file from the DaCapo Benchmark web site above.
The easiest way to obtain the benchmark suite is to download the pre-built jar file from the DaCapo Benchmark web site above.
If, however, you want to build from source read on...
The suite is built using ant. You will need the following tools:
- ant
You need to install this yourself if you don't already have it
http://ant.apache.org
- javacc
Included in our tools directory, or download at
http://javacc.dev.java.net/
* *[ant](http://ant.apache.org)* You need to install this yourself if you don't already have it.
- maven
Included in our tools directory, or download at
http://maven.apache.org/download.html
* *[javacc](http://javacc.dev.java.net/)* Included in our tools directory.
* *[maven](http://maven.apache.org)* Included in our tools directory.
NOTE:
**NOTE**
1. A number of benchmarks including trade and tomcat do not
reliably _build_ under Java 6 (all run under Java 6). Therefore
you must explicitly use a Java 5 VM at build time (see below).
1. A number of benchmarks including trade and tomcat do not reliably _build_ under Java 6 (all run under Java 6). Therefore you must explicitly use a Java 5 VM at build time (see below).
IMPORTANT: before trying to build the suite:
**IMPORTANT:** before trying to build the suite:
1. Set your JAVA_HOME environment variable appropriately (it must
be set and be consistent with the VM that will be used to build
the suite).
1. Set your `JAVA_HOME` environment variable appropriately (it must be set and be consistent with the VM that will be used to build the suite).
2. Copy default.properties to local.properties and edit it for
your environment.
2. Copy `default.properties` to `local.properties` and edit it for your environment.
o Specifically, you must set java14.lib to point to a Java 1.4
installation and java14.compile.classpath to correctly
capture the libraries for that installation(otherwise derby
will not build correctly)
* Specifically, you must set `java14.lib` to point to a Java 1.4 installation and `java14.compile.classpath` to correctly capture the libraries for that installation(otherwise derby will not build correctly)
For more information, run "ant -p" in the benchmarks directory.
For more information, run `ant -p` in the benchmarks directory.
Source Code Structure
---------------------
## Source Code Structure
harness The benchmark harness
### `harness` (The benchmark harness)
This directory includes all of the source code for the DaCapo
harness, which is used to invoke the benchmarks, validate
output, etc.
This directory includes all of the source code for the DaCapo harness, which is used to invoke the benchmarks, validate output, etc.
bms The benchmarks
### `bms` (The benchmarks)
bms/<bm>/src Source written by the DaCapo group to drive the benchmark <bm>
bms/<bm>/downloads MD5 sums for each of the requisite downloads. These are used to
cache the downloads (avoiding re-downloading on each build)
bms/<bm>/data Directory containing any data used to drive the benchmark
bms/<bm>/<bm>.cnf Configuration file for <bm>
bms/<bm>/<bm>.patch Patches against the orginal sources (if any)
bms/<bm>/build.xml Local build file for <bm>
bms/<bm>/build [Directory where building occurs. This is only created at build time]
bms/<bm>/dist [Directory where the result of the build goes. This is only created at build time]
* `bms/<bm>/src` Source written by the DaCapo group to drive the benchmark `<bm>`
* `bms/<bm>/downloads` MD5 sums for each of the requisite downloads. These are used to cache the downloads (avoiding re-downloading on each build)
* `bms/<bm>/data` Directory containing any data used to drive the benchmark
* `bms/<bm>/<bm>.cnf` Configuration file for `<bm>`
* `bms/<bm>/<bm>.patch` Patches against the orginal sources (if any)
* `bms/<bm>/build.xml` Local build file for <bm>
* `bms/<bm>/build` _Directory where building occurs. This is only created at build time._
* `bms/<bm>/dist` _Directory where the result of the build goes. This is only created at build time._
libs Common code used by one or more benchmarks.
### `libs` (Common code used by one or more benchmarks.)
Each of these directories more or less mirror the bm directories.
Each of these directories more or less mirror the `bm` directories.
License
-------
## License
The DaCapo Benchmark Suite conmprises several open source or public
domain programs, plus a test harness, some patches to enable the
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment