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. 106).

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. 49).

--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. 61).

60 HP Caliper Options