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

processors). Do not change this default value: doing so will
result in a useless call graph.
threshold=int An integer value that specifies how HP Caliper counts events.
The default value is zero. Do not change this default value:
doing so will result in a useless call graph.
privilege-level-mask=level Determines the privilege level setting for a given counter.
By default, counters are measured when your application
runs in user space (user). The privilege levels available
are:
• user
• kernel
• all
You can abbreviate this qualifier to PLM. The qualifier is not
case-sensitive.
This option overrides the branch_sampling_spec setting in the scgprof measurement.
When you specify the setting by using the command-line option, you can override all or just part
of the specification. This allows you to, in effect, create your own default settings.
For example, if the measurement configuration file contains this setting:
branch_sampling_spec = "400000, 10%, BRANCH_EVENT"
and on the command line you specify only variation:
--branch-sampling-spec ,5%
the resulting settings would be a rate of 400000, a variation of 5%, and the CPU event
BRANCH_EVENT.
--bus-speed
[--bus-speed int]
Specifies the bus speed in MHz for the sysbus event set. If you specify the sysbus event set,
you must use this option. For example: --bus-speed 200.
--callpath-cutoff
--callpath-cutoff percent_cutoff[,cum_percent_cutoff[,min_count]]
Specifies cutoff values that limit the hot call paths reported in the Hot Call Paths section of the
cstack, scgprof, and cgprofreports.
This option is used in conjunction with the --sort-by metric option, which you can use to
specify the metric to be used for sorting and cutoffs. See “--sort-by” (page 71).
HP Caliper stops reporting information when it reaches a percent cutoff , cumulative percent cutoff,
or minimum number of call paths. You have these choices:
• You can limit the report only to call paths that exceed a specified percentage of the total for
the sorting/cutoff metric. Once HP Caliper encounters this percentage cutoff, it stops reporting
call paths.
• You can limit the report by having HP Caliper stop reporting call paths once the cumulative
percent of the call paths so far listed exceeds the cumulative percentage cutoff value.
• You can specify an integer for the minimum number of call paths to be displayed.
This option has these parameters:
--bus-speed 55