HP Caliper User's Guide

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. The default is user (counters are
measured when your application runs in user
space). The privilege levels are:
• user
• kernel
• all
This qualifier is not case-sensitive, and is
abbreviated to PLM.
-m event_set
You use this form of the option only with the cpu measurement.
An event set is a predefined collection of CPU events you specify with the cpu
measurement. Use this form of the option to measure multiple event sets in the same
run and to specify a privilege level for each event set.
-m event_set[:all|user|kernel][,event_set...]
If no event is specified or if the option value is set to the empty string (""), then no
metrics will be reported.
event_set
A collection of events.
Use all, user, or kernel to specify the privilege level. The default value is user and
kernel.
For details about how to use this form of the -m option, see “Performing CPU Metrics
Analysis ” (p. 197).
-o or --output-file
-o outputfile[,append|create][,per-process|shared][,unique]
Specifies the file in which to write HP Caliper text reports.
Default value is stdout.
You can open the file in one of two modes:
-o or --output-file 67