Example

Assume that you want to capture samples containing the:

•Number of cycles during which three or more FP_OPS_RETIRED events occurred, while executing in kernel space

•Number of cycles during which four or more NOPS_RETIRED events occurred, in user space

•Total number of NOPS_RETIRED at all levels

In addition, assume that you want the samples to be captured every time 10,000 cycles occur, during which two or more IA64_INST_RETIRED events occur, at all privilege levels.

Use this combination of options:

caliper pmu_trace

--event-defaults PLM=all:threshold=3

--metrics FP_OPS_RETIRED:PLM=kernel,NOPS_RETIRED:PLM=user:TH=4,NOPS_RETIRED:TH=0 --sampling-spec 10000,,IA64_INST_RETIRED:TH=2

--exclude-caliper

--exclude-caliper TrueFalse

Specifies whether to include, in measurements, the activity due to the HP Caliper process.

Used only with the --scope system option.

The default value is True (HP Caliper process activity is excluded).

See “--scope” (p. 70).

--exclude-idle

--exclude-idle TrueFalse

Specifies whether to include, in measurements, the periods during which a given CPU is executing the idle loop. Inclusion takes effect for each CPU separately.

Used only with the --scope system option.

The default value is True (idle loop activity is excluded).

See “--scope” (p. 70).

--fold

The --[no]foldoption is deprecated. The closest equivalent to this option is the new --group-byoption.

--frame-depth

--frame-depth count

Specifies the maximum number of stack frames to unwind while collecting call stack samples.

This option is used only with the cstack measurement.

The default depth is 32.

--group-by

--group-by executable module none

Specifies how “matching” processes or modules should have their data combined in reports. (Matching processes or modules are processes or modules that have the same basename.)

This option can be used anytime you use the caliper command to produce a report (including the default stdout report). It can also be used when you use the following commands to create a report from one or more databases: caliper report, caliper merge, and caliper diff.

62 HP Caliper Options