HP-UX Reference (11i v2 07/12) - 1 User Commands A-M (vol 1)

c
caliper(1)
For Integrity Systems Only
caliper(1)
Caliper 4.3 Caliper 4.3
(Requires Optional HP Caliper Software)
l1icache
Provides miss and prefetch usage information for the L1 instruction cache.
l2cache Provides miss rate information for the L2 unified cache. Not available on dual-core
processors.
l2dcache Provides miss rate information for the L2 data cache. Only available on dual-core pro-
cessors.
l2icache Provides miss rate information for the L2 instruction cache. Only available on dual-
core processors.
l3cache Provides miss rate information for the L3 unified cache.
overview Provides an overview of processor activity by collecting multiple event sets.
On non-dual-core processors, the event sets used are:
cpi, stall, dispersal
,
l1dcache, l1icache, l2cache, tlb,
fp.
On dual-core processors, the event sets used are:
cpi, stall, dispersal,
l1dcache, l1icache, l2dcache, l2icache
, tlb, fp, threadswitch .
Note that, on dual-core processors, specifying
overview is equivalent to specifying:
--metrics=cpi,stall,dispersal,\
l1dcache,l1icache,l2dcache,l2icache,\
l2dcache,l2icache,tlb,fp,threadswitch
queues
Provide BRQ (Bus Request Queue) metrics that may give some insight into possible
system bus related performance problems.
stall Provides metrics on primary CPU performance limiters by breaking the CPI into
seven components.
sysbus Provides metrics on system bus utilization. If you specify the sysbus event set, you
must use the --bus-speed option to provide bus speed in MHz. For example,
--bus-speed=200.
tlb Provides metrics related to TLB misses.
threadswitch Provides metrics on hyperthreading thread switch behavior. Only available on dual-
core processors.
Limiting PMU Measurement
For measurements that involve the Itanium PMU, you can restrict measurements to specific parts of your
application. The supported measurements are:
alat, branch, cycles, dcache, dtlb, ecount, fprof, icache, itlb
, pmu_trace ,
scgprof, traps.
By default, HP Caliper measures PMU events for your entire program. However using --user-
regions=rum -sum
allows you to restrict measurements to performance-sensitive regions of code.
To use this feature:
• Modify the application source code to use the header file provided with HP Caliper. The default location
of the header file is caliper_root/include/caliper_control.h.
• In your source code, add the HP Caliper macros to enable and disable the Itanium PMU.
• To enable the PMU, insert:
CALIPER_PMU_ENABLE();
Using CALIPER_PMU_ENABLE() enables the PMU for the current thread until the next
CALIPER_PMU_DISABLE(). When the PMU is already enabled, CALIPER_PMU_ENABLE()
does not have any effect.
• To disable the PMU, insert: CALIPER_PMU_DISABLE();
When the PMU is already disabled, CALIPER_PMU_DISABLE() does not have any effect.
• Use the command-line option --user-regions=rum-sum or place user_regions="rum-
sum"
in a measurement configuration file.
This option causes HP Caliper to allow the measured applications to control the PMU. When specified,
the PMU is initially disabled and HP Caliper will not measure the application until the first
CALIPER_PMU_ENABLE() is executed.
HP-UX 11i Version 2: December 2007 Update − 19 − Hewlett-Packard Company 109