If you use this option but do not specify an event, or if the option value is set to the empty string (""), then no metrics will be reported.

You can use the caliper info command to list available CPU events and their descriptions.

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. 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.

-mevent_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[:alluserkernel][,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 -moption, see “Performing CPU Metrics Analysis ” (p. 151).

-o or --output-file

-o outputfile[,appendcreate][,per-processshared][,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:

append Adds the report results to the end of an existing file that has the specified name.

create Creates a file with the specified name and writes the report results to the file. Replaces any existing file with the specified name.

Default value is create.

50 HP Caliper Options