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

Example

To produce a flat profile based on execution stalls due to GR/GR or GR/load:

$ caliper cycles -ra -s 100000,5%,BE_EXE_BUBBLE.GRALL --etb-freeze-delay 12 --etb-walkback-cycles 22

Choosing correct values for the --etb-freeze-delay and --etb-walkback-cycles options requires knowledge of the Integrity servers dual-core Itanium 2 or Itanium 9300 quad-core processor pipeline. For information about the ETB and how it is configured to collect IP values, see Performance Profiling for Fun and Profit.

--duration 59

Page 59
Image 59
HP UX Caliper Software manual Duration, Etb-freeze-delay, Example