TLBMISS_COST.SH(8)

NAME
tlbmiss_cost.sh - Measure the cost in CPU cycles of a TLB miss

SYNOPSIS
tlbmiss_cost.sh [options]

DESCRIPTION
tlbmiss_cost.sh uses oprofile or calibator to calculate the cost in CPU cycles of servicing a TLB miss. The method used depends on the architecture where the script is being run. On POWERPC, oprofile is used with the STREAM benchmark (available here: http://www.cs.virginia.edu/stream/FTP/Code/stream.c). On X86 and X86-64, calibrator is used (source available here: http://homepages.cwi.nl/~manegold/Calibrator/v0.9e/calibrator.c) These programs will need to be in place and available to tlbmiss_cost.sh in order for cpupcstat to calculate the percentage of time spent servicing TLB misses automatically. tlbmiss_cost.sh can fetch and build these programs for you with the appropriate options. The following options can be used to configure how tlbmiss_cost.sh works:

--calibrator </path/to/calibrator>
    This option allows the user to specify the location of the calibrator tool. If this is not specified the script will check the path and the current working directory for calibrator

--stream </path/to/STREAM>
    This option allows the user to specify the location of the STREAM benchmarking tool (note that is this is not stream(1)). If this is not specified the script will check the path and the current working directory for STREAM

--time-servicing
    Add an additional column printing out what percentage of time was spend servicing TLB misses.

--verbose
    This option increases the verbosity of the ouput.

--quiet
    This option decreases the verbosity of the output.

--fetch-calibrator
    This option has the script attempt to fetch the source for calibrator, builds it, and makes it available to tlbmiss_cost.sh

--fetch-stream
    This option has the script attempt to fetch the source for STREAM, builds it, and makes it available to tlbmiss_cost.sh

SEE ALSO
cpupcstat(8)

AUTHORS
Eric B Munson <ebmunson@us.ibm.com> is the primary author. See the documentation for other contributors.