HP Caliper User Guide Release 5.5 (5900-2351, August 2012)

using a percent symbol (%). For example: -s
CPU_CYCLES,10000,10%
The default value is 5 percent.
cpu_event Specifies a CPU event to measure. The name is not
case-sensitive. For information about CPU events you can
specify, see “Specifying Which CPU Events to Measure”
(p. 93).
threshold=int An integer value that specifies how HP Caliper counts events:
• If the value is zero, HP Caliper counts all events.
• If the value is greater than zero, HP Caliper counts only
the CPU cycles in which the number of events is greater
than or equal to the value you specify.
The default value is zero.
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. This qualifier is
not case-sensitive.
When you specify this option on the command line, you can override all or just part of the
sampling_spec setting in the measurement configuration file or the .caliperinit file. This
allows you to, in effect, create your own default settings.
For example, if the measurement configuration file contains this setting:
sampling_spec = "400000, 10%, BRANCH_EVENT"
and on the command line, you specify only variation:
-s ,5%
the resulting settings would be a rate of 400000, a variation of 5%, and the CPU event
BRANCH_EVENT.
NOTE: Using -s multiple times will not result in sampling on multiple events. If you specify multiple
-s options, only the last one is used.
-v or --version
-v
Prints the HP Caliper version identification. You can also use the what(1) command.
-w
Equivalent to one form of the option for system-wide measurement. The -w option is equivalent to
-–scope system,attr-mod, which is the default for -–scope system. See “Using --scope
system for System-Wide Measurements” (p. 70).
--advice-classes
Used only with the caliper advise command. See “Command Line to Invoke the Advisor”
(p. 78).
-v or --version 53