caliper.1 (2010 09)
c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
and repeat.
Note that because every program is unique, not all of the suggestions will apply.
There are several defaults assumed when portions of the
caliper command-line are omitted. If meas-
urement is omitted, but either a program name or process ID list is given, then the
scgprof measure-
ment is assumed. If
report is omitted, but a database is given, then
report is assumed. If report is
given, but no databases are listed, then
latest is assumed. Finally, if advise is given, but no data-
bases are listed, then all of the databases in the
CALIPER_DATABASES
directory are analyzed.
Finally, there is a full Graphical User Interface (GUI) available as an alternative to the command-line
user interface. The GUI can be used to set up and make measurements as well as graphically explore col-
lected performance data. There are two ways to invoke the GUI:
• The first is to run it on the local machine with the command
caliper -g.
• The second is to install a remote GUI client on a Windows or Linux desktop system, run that program,
and remotely connect to an Integrity server on which the measurements will be made.
Measurement Configuration Files
The measurement argument to the
caliper command is actually the name of a measurement
configuration file. Measurement configuration files determine which measurements
caliper makes.
You can use any of
caliper’s standard measurement configuration files or you can create and use your
own.
The measurement parameter in the command line can be a simple, relative, or absolute file name. If a
simple file name is given, then
caliper first looks in the current working directory for the file. If not
found, then caliper looks in the caliper_root /config directory. By default, caliper is installed in
/opt/caliper on HP-UX, and /opt/hp-caliper
on Linux.
Many of the settings in the measurement configuration file can be overridden by their corresponding
options on the command line.
Note that when making your own measurement configuration file, the first line of the file must be a com-
ment which begins with
# caliper
to pass a caliper validity check.
HP Caliper provides the following standard measurement configuration files. Also see the PLATFORM-
SPECIFIC ADDENDA section for additional platform-specific measurement configuration files that may
be supplied.
alat Measures failed ALAT checks.
branch Measures branch (mis-)predictions.
cstack Measures sampled call stack profile.
cycles Measures sampled cycle profiles. Available only on dual-core Itanium 2 and new quad-
core processors.
dcache Measures data cache misses.
dtlb Measures data TLB misses.
ecount Measures total cpu event counts.
fprof Measures a flat profile of sampled instruction addresses.
icache Measures instruction cache misses.
itlb Measures instruction TLB misses.
overview Collects fprof, dcache, and cstack profiles in a single collection run.
pmu_trace Collects per-(kernel)thread traces of sampled cache misses, TLB misses, ALAT misses,
branch mispredictions, instruction addresses, and CPU events.
scgprof Creates a call graph profile using sampled branch data.
traps Profiles traps, interrupts, and faults. Available only on dual-core Itanium 2 and quad-
core processors.
4 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: September 2010