subtracts this number from the interval to vary the sampling frequency.

 

You can specify the actual number of events by which to

 

vary the sampling rate, or a percentage of the count by

 

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=levelDetermines 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 -smultiple times will not result in sampling on multiple events. If you specify multiple -soptions, only the last one is used.

-v or --version

-v

Prints the HP Caliper version identification. You can also use the what(1) command.

-v or --version 53