--source-path-map

--source-path-map pathmap1[:pathmap2:...]

Specifies the path map to use for finding source files used for reporting source statements.

Applies to any PMU histogram report, which is the only kind of report that references source code.

Path map entries are separated by a colon (:) and applied in order until HP Caliper finds a file match.

•Simple entries are prepended to file names.

•You can provide substitute paths by using comma-separated entries. HP Caliper substitutes the path to the left of the comma with the path to the right of the comma.

•Perl regular expressions are allowed in the left half of a substitution.

--stop-functions

--stop-functions func1[,func2, ...]

As of Caliper 5.2, the kernel unwinding is turned on by default in cstack measurement. When HP Caliper is run as root, the cstack measurement now records and reports both user and kernel space portions of the call stack.

The --stop-functionsoption is used to specify the list of kernel stop functions beyond which the call stack frames are obvious, and there is no interest in showing them. This list is used to avoid unnecessary kernel unwinding. While collecting kernel frames, the unwinding is stopped once any of the specified kernel stop functions is reached.

The default kernel stop functions are specified in the cstack configuration file. They are - real_sleep, sleep_pc, sleep, ksleep, sleep_one, ksleep_one, swtch, swtch_to_thread, sleep_park.

--summary-cutoff

--summary-cutoffpercent_cutoff[,cum_percent_cutoff[,min_count]]

Specifies cutoff values that limit the functions reported in the Function Summary section of a PMU histogram report. This option is used in conjunction with the --sort-bymetric option, which you can use to specify which metric you want to be used for sorting and cutoffs.

HP Caliper stops reporting information when it reaches either a percentage cutoff or a cumulative percentage 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 percentage 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 percentage cutoff value.

You can also specify an integer for the minimum number of functions to be displayed for all load modules.

percent_cutoff

The percentage of the total for the sort metric that a given function

 

must exceed to appear on the report.

 

Default value is 0.1.

 

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.

 

Default value is 100.

72 HP Caliper Options