caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
all This is a synonym for the
src argument.
--dbrp=DBRP_INDEX,PLM,ADDR_MATCH
,ADDR_MASK,PROC_FLAGS
Specifies the bits to program the PMU’s data address range matching registers. Forces event moni-
toring to be constrained by data address ranges.
DBRP_INDEX can be 0, 1, 2 or 3. It identifies one of the four Data Breakpoint Registers (DBRs)
used to specify the desired address range.
PLM specifies the privilege level setting. The privilege levels available are:
user, kernel, and
all.
ADDR_MATCH is the 64-bit address to match. ADDR_MASK is the 56-bit address mask to apply
before matching the ADDR_MATCH bits.
PROC_FLAGS is comma-separated list of
none, d, io
,oriod, as follows:
none Indicates no constraint.
d Indicates data address matching only.
io Indicates instruction address and opcode matching.
iod Indicates instruction address, opcode and data address matching.
--duration=ELAPSED_TIME
(Can also be specified with the -e option).
Specifies how long the measured application should run (in seconds) before
caliper stops measur-
ing it. When caliper stops measuring, the application is resumed and runs freely.
In
cstack measurement, when attaching to a process, if the specified measurement duration is 0,
caliper will generate a pstack like report; in other words, only one callstack sample will be col-
lected for all the threads of the target process and reported.
--event-defaults=
EVENT_PARAM[:EVENT_PARAM]...
Specifies the default CPU event parameters. These apply to all CPU events unless an event-specific
setting is provided for the given parameter.
EVENT_PARAM is defined as:
[{
privilege-level-mask
|PLM}=]{all|user|kernel}|{threshold|T}=THRESHOLD
PLM determines the privilege level setting for a given metric. By default, metrics are measured
when your application runs in user space. The privilege levels available are:
user, kernel, and
all.
THRESHOLD is an integer value that determines the semantics of the counts reported by HP
Caliper. When the threshold is zero (the default), the reported count is the number of occurrences
of the event. When the threshold is not zero, the reported count is the number of CPU cycles during
which the number of occurrences of the event met or exceeded the threshold.
--fprof-sampling-spec=
EVT_PERIOD[,VARIATION[,CPU_EVENT [:EVENT_PARAM]...]]
Controls the sampling rate of the flat profile (fprof) collection in the overview measurement.
This option is valid only when using the overview measurement. See the --sampling-spec
option below for argument details.
--frame-depth=COUNT
Valid only for the cstack measurement, this option specifies the maximum number of frames to
unwind while collecting call stack samples. The default depth is 32.
--ibrp=IBRP_INDEX,PLM,ADDR_MATCH,ADDR_MASK
Specifies the bits to program the PMU’s instruction address range matching registers. Forces event
monitoring to be constrained by instruction addresses ranges.
IBRP_INDEX can be 0, 1, 2 or 3. It identifies one of the four Instruction Breakpoint Register pairs
(IBRPs) used to specify the desired address range.
PLM specifies the privilege level setting. The privilege levels available are:
user, kernel, and
all.
ADDR_MATCH is the 64-bit address to match. ADDR_MASK is the 56-bit address mask to apply
before matching the ADDR_MATCH bits.
6 Hewlett-Packard Company − 6 − HP-UX 11i Version 3: September 2010