HP Caliper User's Guide

NOTE: You can specify a maximum of four events at a time, or 12 on Integrity servers
dual-core Itanium 2 and Itanium 9300 quad-core processors. Depending on how the
PMU registers are used, you might be limited to fewer events on any of the Integrity
servers.
Shortening CPU Event Names
HP Caliper allows you to shorten CPU event names:
• You can truncate the name to the fewest number of characters that uniquely identify
the event, such as CPU_CY to represent CPU_CYCLES.
• You can abbreviate the name using the first letter of each part of the name to create
an acronym, such as CC to represent CPU_CYCLES.
For example, these two methods are valid ways of specifying CPU_CYCLES:
$ caliper fprof -s 400000,10%,CPU_CY myprogram
$ caliper fprof -s 400000,10%,CC myprogram
When two event names have conflicting abbreviations, HP Caliper appends a number
to each abbreviation to differentiate them. If you specify an ambiguous abbreviation,
HP Caliper lists the abbreviations you can use, as in the following example:
$ caliper fprof -s ,,IIR vand
HP Caliper: usage error:
Ambiguous event abbreviation ("IIR") specified for
"--sampling-spec".
Matches IIR2 (IA64_INST_RETIRED), IIR1 (IA32_INST_RETIRED)
Run caliper -h for help.
To list abbreviations for any given event, use the caliper info command to list the
abbreviations:
$ caliper info CPU_CYCLES
=====================================
HP Caliper CPU Counter Information
=====================================
Name: CPU_CYCLES
Abbreviation: CC or CPU_CY
Title: CPU Cycles
Definition: Counts the number of clock cycles.
=====================================
Specifying Which Load Modules to Collect Data For
HP Caliper allows you to restrict data collection to specific load modules. For example,
you can selectively include or exclude data collection for the main executable and any
shared library.
124 Configuring HP Caliper