caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
b Match B-slot
OPCODE_MATCH is the opcode bits against which the instruction encoding is to be matched. On
Dual-Core Itanium and Quad-Core processors, it an integer of 41-bits or less. On Itanium, it is an
integer of 27-bits or less.
OPCODE_MASK is the mask bits to apply to the instruction encoding before matching the
OPCODE_MATCH bits. On Dual-Core Itanium and Quad-Core processors, it an integer of 41-bits or
less. On Itanium, it is an integer of 27-bits or less.
PROC_FLAGS is a comma-separated separated list of
inv, ign,
ibrp0, ibrp1, ibrp2,or
ibrp3, as follows:
•
inv and ign set the inv and
ig_ad bits of the opcode match register. These bits are cleared
by default.
•
ibrp0, ibrp1, ibrp2, and
ibrp3 will clear the corresponding bits in the opcode match
configuration register. These bits are set by default.
--overview=MEASUREMENT_NAME[,MEASUREMENT_NAME...]
Controls the kinds of profiles included in the
overview measurement. The
MEASUREMENT_NAME can be
dcache, fprof,orcstack. By default, the
dcache, fprof,
and
cstack profiles will be included in a per-process
overview collection run.
--process={default|all|root|root-forks|[some:][OPT,...]PATTERN[
,PATTERN] ...}
(Can also be specified with the
-p option).
Specifies which processes in an application’s process tree should be measured.
Use
root to measure only your application’s root process.
Use
root-forks to measure your application’s root process and any processes it forks.
Use
all (the default) to measure all your application’s processes.
For more information, see Process Selection below.
--sampling-spec=
TIME_PERIOD
--sampling-spec=EVT_PERIOD[
,VARIAT ION [,CPU_EVENT[:EVENT_PARAM]...]]
(Can also be specified with the
-s option).
Controls the sampling rate and the event that triggers samples.
The first form (
--sampling-spec=
TIME_PERIOD) is used only for the cpu and cstack meas-
urements.
The second form is used for all other sample-based measurements (
fprof, dcache, icache,etc.).
TIME_PERIOD is a sampling period in seconds, milliseconds, or microseconds (specified as N
s,
N
ms, Nus, respectively, where N is an integer).
For the
cpu measurement, the default TIME_PERIOD is 8ms of CPU time (see also --cpu-
aggregation=COUNT).
For the
cstack measurement, the default TIME_PERIOD is 100 milliseconds (wall-clock time).
Note that time is measured in CPU cycles (for cpu measurement) or real time (for cstack meas-
urement).
EVT_PERIOD specifies how many sampling events should occur between samples.
VARIAT ION specifies how much to vary the number of events between samples (may be specified as
either an exact count or as a percentage of the sampling rate if followed by
%).
CPU_EVENT specifies the CPU event to use for sampling. You can list CPU events available (along
with descriptions) by using
caliper info (see Information Options below).
EVENT_PARAM allows you to change the privilege level (default:
user) and threshold (default: 0)
in effect for the CPU event counter used to trigger samples. See --event-defaults above for
the syntax of EVENT_PARAM.
In
fprof measurement, caliper supports simultaneous sampling of IP on multiple PMU events.
To perform this, the user has to provide multiple sampling specifications, based on which the IP
samples will be collected and reported.
8 Hewlett-Packard Company − 8 − HP-UX 11i Version 3: September 2010