README.md

cacheSimulator

Cache Simulator for ECEN 4593 (Comp Org)

GitHub Crash Course

	# clones repo to local (only done once)
	git clone https://github.com/chris-womack/cacheSimulator.git

	# this will add all(.) new files in the dir that you've created
	git add .

	# add specific file
	git add <file Name>

	# commits or saves all(-a) the changes you've made. use comments to keep track (-m)
	git commit -am "comment"

	# pulls master repo to update your local repo if changes have been made. 
	# Should be done before every code session.
	git pull origin master
	git pull origin <branch name>

	# push to the master repo. this is were we run into conflictsS
	git push origin master
	git push origin <branch name>

	# creates branch that will be seperate from master
	git branch <branch name>

	# moves from current branch or master to branch specified
	git checkout <branch name>

	# merges current branch (you location) with <branch name> asub
	# So its another point where conflicts can occur
	git merge <branch name>

Using cacheSim

Unzipped

./<simulator name> <config file> < <tracefile name>
./cachSim config.txt < traces-short/tr1

Zipped

zcat <tracefile name> | <simulator name> <config file>
zcat bzip2.gz | cacheSim config.txt

Traces

Short Traces

Located in traces-short. The short traces are:

• tr1
• tr2
• tr3
• tr4
• tr5
• tr6

Long Traces

Located in traces-long. The long (production) traces are:

• bzip2.gz Block sorting compression
• h264ref.gz Video compression
• omnetpp.gz Discrete event simulation library
• libquantum.gz Quantum computer simulation
• sjeng.gz Chess game

Other Traces

The traces-1M and traces-5M directories contain the first 1 million and 5 million instruction of the long traces. There are compressed and uncompressed versions of the traces.