HP Caliper User Guide Release 5.5 (5900-2351, August 2012)

HP Caliper stops reporting information when it reaches either a percent cutoff or a cumulative
percent cutoff:
• You can limit the report only to functions that exceed a specified percentage of the total for
the sorting/cutoff metric. Once HP Caliper encounters this percent cutoff, it stops reporting
functions.
• You can limit the report by having HP Caliper stop reporting functions once the cumulative
percent of the functions so far listed exceeds the cumulative percent cutoff value.
You can also specify an integer for the minimum number of functions to be displayed for all load
modules.
For details, see “Metrics You Can Use for Report Sorting and Cutoffs” (p. 105).
percent_cutoff The percentage of the total for the sorting/cutoff metric that a given
function must exceed to appear on the report. This is shown as percent
cutoff on reports.
Default value is 1.0.
This value only takes effect if the Percent of Total column is selected
for the report.
cum_percent_cutoff The value of the cumulative percentage at which HP Caliper stops
reporting results. This is shown as cumulative percent cutoff on reports.
Default value is 100.
This value only takes effect if the Cumulative percent column is
selected for the report.
min_count Sets the minimum number of functions to be displayed for all load
modules. This is shown as minimum function entries on reports.
Default value is zero.
Example
If you specify:
$ caliper fprof --detail-cutoff ,80 wordplay
The contents of the Function Details section is a list of functions containing:
• The functions that account for 80 percent of the total IP samples in the wordplay program.
• Only those functions that each account for more than one percent of total samples for all load
modules. Because percent_cutoff was not specified, HP Caliper used the default value,
1 percent.
--duration
See “-e or --duration” (p. 48).
--etb-freeze-delay
--etb-freeze-delay integer
Controls the number of cycles of programmable delay for the Integrity servers dual-core Itanium 2
and Itanium 9300 quad-core processors' execution trace buffer (ETB) from the point of the rest of
the PMU freeze.
Use this option to change the way in which the ETB collects the samples. When you specify a
nonzero value with this option, the ETB will continue to collect instruction pointer (IP) samples for
the specified number of cycles from the point of the rest of the PMU freeze.
See also “--etb-walkback-cycles” (p. 60).
--duration 59