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 Last updated 2009-12-18
...@@ -8,109 +7,80 @@ It consists of a set of open source, real world applications with ...@@ -8,109 +7,80 @@ It consists of a set of open source, real world applications with
non-trivial memory loads. non-trivial memory loads.
Guidelines for use ## Guidelines for use
------------------
When quoting results in publications, the authors of this suite When quoting results in publications, the authors of this suite
strongly request that: 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 * The suite be cited in accordance with the usual standards of acknowledging credit in academic research.
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 * 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.
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
The easiest way to obtain the benchmark suite is to download the pre-built jar file from the DaCapo Benchmark web site above.
Building
--------
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... If, however, you want to build from source read on...
The suite is built using ant. You will need the following tools: The suite is built using ant. You will need the following tools:
- ant * *[ant](http://ant.apache.org)* You need to install this yourself if you don't already have it.
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/
- maven * *[javacc](http://javacc.dev.java.net/)* Included in our tools directory.
Included in our tools directory, or download at
http://maven.apache.org/download.html
* *[maven](http://maven.apache.org)* Included in our tools directory.
NOTE: **NOTE**
1. A number of benchmarks including trade and tomcat do not 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).
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 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).
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 2. Copy `default.properties` to `local.properties` and edit it for your environment.
your environment.
o Specifically, you must set java14.lib to point to a Java 1.4 * 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)
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 This directory includes all of the source code for the DaCapo harness, which is used to invoke the benchmarks, validate output, etc.
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>/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 * `bms/<bm>/downloads` MD5 sums for each of the requisite downloads. These are used to cache the downloads (avoiding re-downloading on each build)
cache the downloads (avoiding re-downloading on each build) * `bms/<bm>/data` Directory containing any data used to drive the benchmark
bms/<bm>/data Directory containing any data used to drive the benchmark * `bms/<bm>/<bm>.cnf` Configuration file for `<bm>`
bms/<bm>/<bm>.cnf Configuration file for <bm> * `bms/<bm>/<bm>.patch` Patches against the orginal sources (if any)
bms/<bm>/<bm>.patch Patches against the orginal sources (if any) * `bms/<bm>/build.xml` Local build file for <bm>
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>/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>/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 The DaCapo Benchmark Suite conmprises several open source or public
domain programs, plus a test harness, some patches to enable the 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