HP Caliper User's Guide

variation
Specifies how much to vary the number of events
between samples. The number or percentage of
CPU_counter events that HP Caliper uses to
vary the sampling rate. HP Caliper adds or
subtracts this number from the interval to vary
the sampling frequency.
The default value is 5 percent.
cpu_event
Specifies CPU events to measure. The default
value is BRANCH_EVENT (or ETB_EVENT on
the Integrity servers dual-core Itanium 2 and
Itanium 9300 quad-core 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.
--branch-sampling-spec 73