copied v0.3 in trunk, prepped v0.3 release tarball

git-svn-id: https://acavus.elis.ugent.be/svn/MICA/trunk@57 807cdcb1-511e-4608-a72a-c2ff732aa92f

LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2007-2011, Kenneth Hoste and Lieven Eeckhout (Ghent University, Belgium)
+kehoste@elis.ugent.be, leeckhou@elis.ugent.be
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+    * Neither the name of the organization nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

makefile → Makefile

@@ -5,7 +5,7 @@ CXXFLAGS ?= -Wall -Werror -Wno-unknown-pragmas $(DBG) $(OPT)
 
 CXX=g++
 
-all: mica_v0-23
+all: mica
 
 mica_all.o: mica.h mica_all.h mica_all.cpp
 	$(CXX) -g -c $(CXXFLAGS) $(PIN_CXXFLAGS) mica_all.cpp -o mica_all.o
@@ -37,12 +37,12 @@ mica_memfootprint.o: mica.h mica_memfootprint.h mica_memfootprint.cpp
 mica_memreusedist.o: mica.h mica_memreusedist.h mica_memreusedist.cpp
 	$(CXX) -g -c $(CXXFLAGS) $(PIN_CXXFLAGS) mica_memreusedist.cpp -o mica_memreusedist.o
 
-mica_v0-23.o: mica.h mica_v0-23.cpp
-	$(CXX) -g -c $(CXXFLAGS) $(PIN_CXXFLAGS) mica_v0-23.cpp -o mica_v0-23.o
+mica.o: mica.h mica.cpp
+	$(CXX) -g -c $(CXXFLAGS) $(PIN_CXXFLAGS) mica.cpp -o mica.o
 
-mica_v0-23: mica.h mica_v0-23.o mica_all.o mica_init.o mica_utils.o mica_ilp.o mica_itypes.o mica_ppm.o mica_reg.o mica_stride.o mica_memfootprint.o mica_memreusedist.o
-	$(CXX) -g $(PIN_LDFLAGS) $(LINK_DEBUG) mica_v0-23.o mica_all.o mica_init.o mica_utils.o mica_ilp.o mica_itypes.o mica_ppm.o mica_reg.o mica_stride.o mica_memfootprint.o mica_memreusedist.o -o mica_v0-23 $(PIN_LPATHS) $(PIN_LIBS) $(DBG)
+mica: mica.h mica.o mica_all.o mica_init.o mica_utils.o mica_ilp.o mica_itypes.o mica_ppm.o mica_reg.o mica_stride.o mica_memfootprint.o mica_memreusedist.o
+	$(CXX) -g $(PIN_LDFLAGS) $(LINK_DEBUG) mica.o mica_all.o mica_init.o mica_utils.o mica_ilp.o mica_itypes.o mica_ppm.o mica_reg.o mica_stride.o mica_memfootprint.o mica_memreusedist.o -o mica.so $(PIN_LPATHS) $(PIN_LIBS) $(DBG)
 
 
 clean: 
-	rm -f *.o mica_v0-23 *pin*out mica*log*
+	rm -f *.o mica.so *pin*out mica*log*

README

@@ -1,6 +1,6 @@
 MICA: Microarchitecture-Independent Characterization of Applications
 ====================================================================
-version 0.23
+version 0.3
 
 Kenneth Hoste & Lieven Eeckhout (Ghent University, Belgium)
 

RELEASE_NOTES

@@ -1,13 +1,29 @@
-X Xth 2009
+February 27th 2011
 ------------------
 
 MICA v0.3
 
-- increases flexibility of itypes analysis significantly
+- increased flexibility of itypes analysis significantly
         - instruction groups used in itypes analysis can be specified by the user now,
           using a itypes.spec file; specify the filename in mica.conf using an entry like:
                 itypes_spec_file: <filename>
-        - by default, the old instruction groups are used
+        - by default, the old instruction groups are used 
+          (except for SYSCALL, which was added to the group formely known as 'other')
+- made block size in ilp, memfootprint and memreusedist flexible
+        - size can be set by specifying 'block_size: <power of 2>' in the mica.conf file
+        - default block size is 2^6 (64) bytes, which is a change compared to MICA v0.23 for ilp
+- made page size in memfootprint flexible
+        - size can be set by specifying 'page_size: <power of 2>' in the mica.conf file
+        - default page size is 4096 (2^12) bytes
+- possibly expensive assert statements and other sanity checks were removed
+- bug fixes: 
+        - memory read size wasn't being used 100% correctly
+          in ilp, memfootprint, memreusedist and stride analysis,
+          the size was being added to the start address of the read,
+          while (size-1) should be added; otherwise, e.g. for memfootprint,
+          we count an extra block being touched if the access is near a block boundary
+        - a small problem with an assert statement was fixed in memfootprint (>= 0 instead of >)
+        - fprintf statements were fixed for 64-bit systems
 
 
 September 22th 2009

itypes_default.spec

@@ -0,0 +1,30 @@
+0, 0, SPECIAL, mem_read
+1, 0, SPECIAL, mem_write
+2, 0, CATEGORY, COND_BR
+2, 1, CATEGORY, UNCOND_BR
+2, 2, OPCODE, LEAVE
+2, 3, OPCODE, RET_NEAR
+2, 4, OPCODE, CALL_NEAR
+3, 0, CATEGORY, LOGICAL
+3, 1, CATEGORY, DATAXFER
+3, 2, CATEGORY, BINARY
+3, 3, CATEGORY, FLAGOP
+3, 4, CATEGORY, BITBYTE
+4, 0, CATEGORY, X87_ALU
+4, 1, CATEGORY, FCMOV
+5, 0, CATEGORY, POP
+5, 1, CATEGORY, PUSH
+6, 0, CATEGORY, SHIFT
+7, 0, CATEGORY, STRINGOP
+8, 0, CATEGORY, MMX
+8, 1, CATEGORY, SSE
+9, 0, CATEGORY, INTERRUPT
+9, 1, CATEGORY, ROTATE
+9, 2, CATEGORY, SEMAPHORE
+9, 3, CATEGORY, CMOV
+9, 4, CATEGORY, SYSTEM
+9, 5, CATEGORY, MISC
+9, 6, CATEGORY, PREFETCH
+9, 7, CATEGORY, SYSCALL
+10, 0, CATEGORY, WIDENOP
+10, 1, CATEGORY, NOP

mica.conf.example

@@ -1,3 +1,6 @@
 analysis_type: ilp_one
 interval_size: full
 ilp_size: 32
+block_size: 6
+page_size: 12
+itypes_spec_file: itypes_default.spec