SPECaccel®2023 Documentation

(To check for possible updates to the SPECaccel 2023 documentation, see http://www.spec.org/accel2023/Docs/.

Suggested reading order:

If you are just getting started with SPECaccel 2023 here is a suggested reading order:

1. Start with readme1st.html to get an overview of the suite and the process.

2. Use system-requirements.html to help you choose which computer to use as your first test system.

3. Once you've chosen the test system, install the suite, using install-guide-unix.html. Please note that Windows operating system has not been tested or is supported.

4. Read at least the first part of runaccel.html, because runaccel is the primary tool in the suite. It is used to build the benchmarks, run them, and report on their results. You should read at least section 1 through section 3.1 of that document.

5. After that, you can pick and choose which documents to read based on where your needs may take you. The list in the next section can help you decide. Note that the run rules will need to be studied carefully if you plan to quote results in public.

List of documents

The following documents are included with SPECaccel 2023

changes-in-v2.0.html

A summary of the changes that have been made in the SPECaccel20232023 aka Version 2.0 release.

config.html

SPECaccel 2023 provides benchmarks in source code form, which are compiled under control of SPEC's toolset. A config file controls how they are compiled, and also controls various settings for your tests. If you are new to the suite, you will probably start with an existing config file, such as one downloaded from www.spec.org/accel2023. Eventually, you will either want to understand the details of what is inside that config file, or you will want to write your own. This document tells you how.

credits.html

Information about the contributors to SPECaccel2023

errata.html

Known problems and errata information.

faq.html

Frequently asked technical questions

flag-description.html

When the benchmarks are compiled, compilation flags (such as -O5 or -unroll) are detected and automatically reported by the tools. A flag description file helps the tools recognize such flags and describe them in reports. The tester is responsible for providing a flag description file to go with his or her config file. This document tells you how to write a flag description file.

Note that if you are just getting started with ACCEL, you may find that your starter config file already points to a valid flags description, via the config file flagsurl field.

install-guide-unix.html

How to install SPECaccel2023on Unix, Linx, and Mac OS X systems. Includes an example installation and an example of running the first benchmark.

legal.html

Copyright notice and other legal information.

makevars.html

Advanced users of the suite who want to understand exactly how the benchmarks are built can use this file to help decipher the process.

monitors.html

Information about monitoring hooks.

readme1st.html

Written in the form of questions and answers, this document provides useful background information to the SPECaccel 2023 benchmarks, explains which system components are measured, gives a high-level overview of the benchmarking steps, summarizes the contents of the SPECaccel2023package, and details types of metrics available with the suite.

runrules.html

The SPECaccel 2023 Run and Reporting rules. These must be followed for generating publicly disclosed results. If you plan to quote results in public, you will need to study these rules carefully.

runaccel.html

Information on the "runaccel" command, which is the primary user interface for running SPECaccel 2023 benchmarks and reporting results.

runaccel-avoidance.html

Some users prefer to avoid using the SPEC-supplied toolset, because they have specialized tasks that require more direct access to the benchmarks. Such tasks might include instrumenting the code, doing performance traces, or debugging an experimental compiler. This document describes how you can use SPEC's tools for the minimal purpose of just generating work directories, for use as a private sandbox.

sysinfo

A SPEC result includes a system description. If your system allows it, you may be able to automate part of the process of gathering a system description. This perl script provides an example of how that might be done. Note: some web browsers may refuse to open a file of type ".pl". If clicking on the link doesn't work, try saving the file and opening it with your favorite text editor.

system-requirements.html

A list of the hardware and software needed in order to run the SPECaccel2023suite.

techsupport.html

Information on SPEC technical support.

tools-build.html

How to build (or re-build) the tools such as runaccel

utility.html

How to use various utilities, such as specinvoke, specdiff, and specmake.

Benchmark Documentation

Some individual benchmark in the suite have additional documents, found in the benchmark "Docs" subdirectory on your installed benchmark tree, or on the ACCEL distribution media. For example, additional information about 450.md may be found in:

$SPEC/benchspec/ACCEL/450.md/Docs/benchmarks/450.md.html

Redistributable Sources

On the SPEC distribution, you will find:

redistributable_sources/README      Information about freely-available sources
                                    that have been incorporated in SPECaccel

Copyright © 2014-2023 Standard Performance Evaluation Corporation
All Rights Reserved