HP Caliper 5.3 User Guide (5900-1558, February 2011)

Specifies whether the target application should be blocked when the PMU sampling buffer is full.
The default is TRUE (i.e., the target application will be blocked until HP Caliper has completed
processing all the samples in the buffer). This option is valid only for PMU based per-process
measurements on Linux.
--per-module-data
--per-module-data True|False
Specifies that all function histograms will be reported by load module instead of the default of
reporting across load modules. Applies only to a PMU histogram report.
--percent-columns
--percent-columns total|cumulative|total:cumulative
Controls whether or not the % Total and Cumulat % of Total columns appear in reports.
The % Total column shows the percent of the total value of a given metric that is attributable to a
given program object. The Cumulat % of Total column shows a running sum of the percent of the
total value of a given metric attributable to the given program object and those listed above it.
Specify total to have reports include a % Total column.
Specify cumulative to have reports include a Cumulat % of Total column.
The default is total:cumulative.
--percent-sample
--percent-sample=threads|process
Displays per thread data with percentages calculated for samples collected for each thread or for
the process. The default value is process. It is helpful if an application has distinct groups of
threads that perform different tasks entirely, so displaying their IP statistics as a percentage of
individual threads is more relevant.
--prim-cutoff
--prim-cutoff percent_cutoff[,cum_percent_cutoff[,min_count]]
Specifies cutoff values that limit the blocking primitives reported in the Primitives section of the
cstack report.
HP Caliper stops reporting information when it reaches a percent cutoff, cumulative percent cutoff,
or minimum number of primitives. You have these choices:
• You can limit the report only to primitives that exceed a specified percentage of the total for
the blocking samples. Once HP Caliper encounters this percentage cutoff, it stops reporting
primitives.
• You can limit the report by having HP Caliper stop reporting call paths once the cumulative
percent of the primitives so far listed exceeds the cumulative percentage cutoff value.
• You can specify an integer for the minimum number of primitives to be displayed.
This option has these parameters:
percent_cutoff The percentage of the total for the blocked samples that a given
primitive must exceed to appear in a report. This is shown as percent
cutoff on reports.
Default value is 1.0.
--per-module-data 67