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

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 True|False
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. 69).
--exclude-idle
--exclude-idle True|False
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. 69).
--fold
The --[no]fold option is deprecated. The closest equivalent to this option is the new --group-by
option.
--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.
--exclude-caliper 61