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 TrueFalse

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 totalcumulativetotal: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=threadsprocess

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-cutoffpercent_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