The simplescalar tool set, version 2.0(2)

under Contract DABT63-95-C-0127 and ARPA order no. D346. The current support for this work comes from a variety of sources, all of to which we are indebted.

This tool set is distributed “as is” in the hope that it will beuseful. The tool set comes with no warranty, and no author ordistributor accepts any responsibility for the consequences of itsuse.

Everyone is granted permission to copy, modify and redistrib-ute this tool set under the following conditions: This tool set is distributed for non-commercial use only.

Please contact the maintainer for restrictions applying tocommercial use of these tools. Permission is granted to anyone to make or distribute cop-ies of this tool set, either as received or modi ed, in any

medium, provided that all copyright notices, permission andnonwarranty notices are preserved, and that the distributorgrants the recipient permission for further redistribution aspermitted by this document. Permission is granted to distribute these tools in compiled

or executable form under the same conditions that apply forsource code, provided that either: (1) it is accompanied bythe corresponding machine-readable source code, or (2) itis accompanied by a written offer, with no time limit, to giveanyone a machine-readable copy of the correspondingsource code in return for reimbursement of the cost of distri-bution. This written offer must permit verbatim duplicationby anyone, or (3) it is distributed by someone who receivedonly the executable form, and is accompanied by a copy ofthe written offer of source code that they received concur-rently.

In other words, you are welcome to use, share and improvethese tools. You are forbidden to forbid anyone else to use, shareand improve what you give them.

These utilities are not required to run the simulators them-selves, but is required to compile your own SimpleScalarbenchmark binaries (e.g. test programs other than the oneswe provide). The compressed le is 3 MB, the uncom-pressed le is 14 MB, and the build requires 52 MB. simpletools.tar.gz - contains the retargeted GNU compiler

and library sources needed to build SimpleScalar bench-mark binaries (GCC 2.6.3, glibc 1.0.9, and f2c), as well aspre-built big- and little-endian versions of libc. This le isneeded only to build benchmarks, not to compile or run thesimulators. The tools are 11 MB compressed, 47 MBuncompressed, and the full installation requires 70 MB. simplebench.big.tar.gz - contains a set of the SPEC95

benchmark binaries, compiled to the SimpleScalar architec-ture running on a big-endian host. The binaries take under 5MB compressed, and are 29 MB when uncompressed. simplebench.little.tar.gz - same as above, except that the

binaries were compiled to the SimpleScalar architecturerunning on a little-endian host.

Once you have selected the appropriate les, place the down-loaded les into the desired target directory. If you obtained the les with the “.gz” suf x, run the GNU decompress utility (gun-zip). The les should now have a “.tar” suf x. To remove thedirectories from the archive:

tar xf filename.tar

2.1 Obtaining the tools

The tools can either be obtained through the World WideWeb, or by conventional ftp. For example, to get the lesim-plesim.tar.gz via the WWW, enter the URL:

ftp://ftp.cs.wisc.edu/sohi/Code/simplescalar/

simplesim.tar

and to obtain the same le with traditional ftp:

ftp ftp.cs.wisc.eduuser: anonymous

password: enter your e-mail address herecd sohi/Code/simplescalarget simplesim.tar

Note the “tar.gz” suf x: by requesting the le without the “.gz”suf x, the ftp server uncompresses it automatically. To get thecompressed version, simply request the le with the “.gz” suf x.The ve distribution les in the directory (which are symboliclinks to the les containing the latest version of the tools) are: simplesim.tar.gz - contains the simulator sources, the

instruction set de nition macros, and test program sourceand binaries. The directory is 1 MB compressed and 4 MBuncompressed. When the simulators are built, the directory(including object les) will require 11 MB. This le isrequired for installation of the tool set. simpleutils.tar.gz - contains the GNU binutils source (ver-sion 2.5.2), retargeted to the SimpleScalar architecture.

If you download and unpack all les, release, you should have

the following subdirectories with following contents: simplesim-2.0 - the sources of the SimpleScalar processor

simulators, supporting scripts, and small test benchmarks. Italso holds precompiled binaries of the test benchmarks. binutils-2.5.2 - the GNU binary utilities code, ported to the

SimpleScalar architecture. ssbig-na-sstrix - the root directory for the tree in which the

big-endian SimpleScalar binary utilities and compiler toolswill be installed. The unpacked directories contain header les and a pre-compiled copy of libc and a necessary object le. sslittle-na-sstrix - same as above, except that this directory

holds the little-endian versions of the SimpleScalar utilities. gcc-2.6.3 - the GNU C compiler code, targeted toward the

SimpleScalar architecture. glibc-1.09- the GNU libraries code, ported to the SimpleS-calar architecture. f2c-1994.09.27 - the 1994 release of AT&T Bell Labs’

FORTRAN to C translator code. spec95-big - precompiled SimpleScalar SPEC95 bench-mark binaries (big-endian version).

spec95-little - precompiled SimpleScalar SPEC95 bench-mark binaries (little-endian version)

2.2 Installing and running Simplescalar

We depict a graphical overview of the tool set in Figure1.Benchmarks written in FORTRAN are converted to C using BellLabs’ f2c converter. Both benchmarks written in C and thoseconverted from FORTRAN are compiled using the SimpleScalar