#
# Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# ident	"@(#)README.performance_check	1.1	05/10/05 SMI"
#
#
#	PERFORMANCE_CHECK
#
# This explains how to enable and use the PERFORMANCE_CHECK feature
#

[-] Enabling this Features:

    1) Recompile legion
    You will need to compile legion with PERFORMANCE_CHECK=1.
    Edit your GNUMakefile in your legion build directory and
    re-compile legion.

    2) Edit your config file (Optional Step)
    Modify your legion config file and add the 'perf_cycle_gap' value
    to your processor directive. You can use this variable to override
    the default value for perf_cycle_gap which is 10000000 instns.
    This determines the gap between performance checks in number of
    instructions executed. Decreasing this below the default can
    impact the performance of your legion.

    Example:
                processor "niagara" {
                        clkfreq 5000000 ;
                        cores 1;
                        vthreads 1;
                        nglobals 4;
                        nwins 8;
                        rstv 0xfff0000020;
                        maxtl 7;
			perf_cycle_gap 0x10000000; 
		}

[-] Output

    When running legion in this mode, the simulation will print
    performance statistics since every 10000000 instns.

    Example:

[0] Simulator mips=12.26, average mips=12.26, total_time=0 seconds, delta_time=815 milliseconds
[0] Instn cnts: R=19 (0.00%), H=151008 (1.51%), P=9848973 (98.49%), U=0 (0.00%), Total=10000000
[0] xdcache: hits=2629150 (96.18%), misses=104374 (3.82%), avg_hits=(96.18%)
[0] xicache: hits=9997121 (99.97%), misses=2879 (0.03%), avg hits=(99.97%)
Instn count delta : 10000000
[0] Simulator mips=21.82, average mips=15.70, total_time=1 seconds, delta_time=458 milliseconds
[0] Instn cnts: R=19 (0.00%), H=188652 (0.94%), P=19811329 (99.06%), U=0 (0.00%), Total=20000000
[0] xdcache: hits=3139833 (98.27%), misses=55321 (1.73%), avg_hits=(97.31%)
[0] xicache: hits=9990666 (99.91%), misses=9334 (0.09%), avg hits=(99.94%)
Instn count delta : 10000000
[0] Simulator mips=20.66, average mips=17.07, total_time=1 seconds, delta_time=484 milliseconds
[0] Instn cnts: R=19 (0.00%), H=189247 (0.63%), P=29810734 (99.37%), U=0 (0.00%), Total=30000000
[0] xdcache: hits=3724278 (99.46%), misses=20038 (0.54%), avg_hits=(98.14%)
[0] xicache: hits=9999780 (100.00%), misses=220 (0.00%), avg hits=(99.96%)
Instn count delta : 10000000
[0] Simulator mips=19.93, average mips=17.70, total_time=2 seconds, delta_time=501 milliseconds
[0] Instn cnts: R=19 (0.00%), H=204476 (0.51%), P=39795505 (99.49%), U=0 (0.00%), Total=40000000
[0] xdcache: hits=3606325 (99.54%), misses=16692 (0.46%), avg_hits=(98.52%)
[0] xicache: hits=9998143 (99.98%), misses=1857 (0.02%), avg hits=(99.96%)
Instn count delta : 10000000