Dinero IV, release 7, 6 February 1998Send feedback to edler@research.nj.nec.com and markhill@cs.wisc.edu.INTRODUCTIONDinero IV is a cache simulator for memory reference traces.It includes the following major changes over Dinero III:	- subroutine-callable interface in addition to trace-reading program	- simulation of multi-level caches	- simulation of dissimilar I and D caches	- better performance, especially for highly associative caches	- classification of compulsory, capacity, and conflict misses	- support for multiple input formats	- cleaned up and modernized code, improved portabilitySome deep-seated limitations:- Dinero IV is not a timing simulator.  There is no notion of simulated time or cycles, only references.- Dinero IV is not a functional simulator.  Data & instructions do not move in and out of the caches;  in fact they don't exist!  The primary result of simulation  with Dinero IV is hit and miss information.- Dinero IV isn't multi-threaded.  If you have a multiprocessor with enough memory,  you can run multiple independent simulations concurrently.The basic idea is to simulate a memory hierarchy consisting of variouscaches connected as one or more trees, with reference sources(the processors) at the leaves and a memory at each root.  The variousparameters of each cache can be set separately (architecture, policy,statistics).  During initialization, the configuration to be simulatedis built up, one cache at a time, starting with each memory as a specialcase.  After initialization, each reference is fed to the appropriatetop-level cache by a single simple function call.  Lower levels of thehierarchy are handled automatically.At some future time, Dinero IV may be extended to simulate multiprocessors.In the meantime, there is no support for consistency, so for practicalpurposes, the tree of caches will not be very branchy (the only timewhere multiple sources will feed into a cache is when separate instructionand data caches are used).STRUCTURE AND DOCUMENTATIONThe subroutine-callable version of Dinero IV consists of a library(libd4.a) and a header file (d4.h).  Unix man pages are in d4.[13].The program dineroIV is implemented by using the subroutine interface.Run dineroIV -help to see the latest usage summary.The file NOTES, in this directory, contains some additional information,comparing Dinero IV with Dinero III, and providing some detailsabout the internal structure of Dinero IV.The file CHANGES, in this directory, gives a history of thechanges from one release of Dinero IV to the next.INSTALLATIONDinero IV is built with Gnu autoconf, and has been tested withx86/Linux, Alpha/Linux, Alpha/OSF, SGI/IRIX-6, RS6000/AIX,x86/Solaris, and Sparc/Solaris.To build everything:	./configure	makeNothing is installed outside the main directory.To turn on a bit of additional debugging, configure with --with-debug.TESTINGTo run some fixed tests, go to the testing subdirectory and run	make	PATH=$PATH:.. ./testscript	D4_SRC=.. PATH=$PATH:.. ./testscript -c(for sh users; csh users probably use "set path=($path ..); set D4_SRC=..").Note some of the tests produce results dependent on the random numbergenerator (random()).  This works fine normally, but some systems haveversions of random() that produce a different sequence of numbers,so the results of some tests will differ from the supposedly good resultsalready saved for comparison (produced on x86/Linux).  The tests in questionare those with random replacement or a nonzero pfabort value.