NAME

       cpupcstat - Measure the DTLB miss rate

SYNOPSIS

       cpupcstat [options] [target]

DESCRIPTION

       cpupcstat  uses  oprofile  to measure the DTLB miss rate of a specified application or the
       kernel.  It configures oprofile to count the number of DTLB misses, optionally starts  the
       target, and reports on the miss rate over a specified interval as target executes.

       The following options can be used to configure how cpupcstat works:

       --vmlinux </path/to/vmlinux>

              This  allows  the  user  to specify where the appropriate vmlinux file is for their
              kernel.  If this is not specified, /boot/vmlinux-`uname -r` will be used.

       --delay <seconds>

              This allows the user to specify the reporting interval.  The default is 10 seconds.

       --target-global

              Gather statistics for all processes and the kernel running in the system.

       --target-pid <pid>

              This allows the user to specify the pid  of  a  process  already  that  is  already
              running.  If this option is specified, target will be ignored.

       --real-target <real-target>

              Use  this  to  specify  the  real name of the program to monitor if the target is a
              launcher script.  When this is specified, target is executed but the report will be
              for real-target.

       --time-limit <sec>

              This option sets the time limit for monitoring.  If this is specified the target or
              pid will only be monitored for sec seconds.  The default continues monitoring while
              target or pid are still alive.

       --kernel

              This  allows the user to request DTLB miss rate data be collected for the kernel as
              well as the target.

       --misses-per-instruction

              This option requests that the ratio of instructions retired per TLB miss.

       --misses-per-cycle

              This option requests that the ratio of CPU cycles per TLB miss.

       --time-servicing

              This option requests that the percentage of CPU cycles spent servicing  TLB  misses
              is displayed when cpupcstat exits.  To use this option the cost in CPU cycles for a
              single TLB miss must be specified using either  the  --cost-config  option  or  the
              tlbmiss_cost.sh script.

       --cost-config </path/to/config>

              This  option tells cpupcstat that the cost in CPU cycles of a TLB miss can be found
              in the specified file, it should be specified as:

              TLB_MISS_COST=XX

              Where XX is the cost in cycles.  This option is only used with the --time-servicing
              option.

       --force-oprofile

              cpupcstat prefers the perf tool for data collection, only using oprofile if perf is
              not present or supported.  This option will force cpupcstat  to  use  oprofile  for
              data collection.

SEE ALSO

       oprofile(1) perf(1) tlbmiss_cost.sh(8)

AUTHORS

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

                                           9 June, 2009                              CPUCPSTAT(8)