HP-UX Reference (11i v2 07/12) - 1 User Commands A-M (vol 1)
c
caliper(1)
For Integrity Systems Only
caliper(1)
Caliper 4.3 Caliper 4.3
(Requires Optional HP Caliper Software)
You can also write your own rules customized to your application. This is an iterative process where you
first make one or more caliper performance runs saving the results in databases, run
caliper advise
on those databases, review the suggestions, make changes to your program and/or how it is built, 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 if 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 databases
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 collected
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 sim-
ple 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 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.
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.
94 Hewlett-Packard Company − 4 − HP-UX 11i Version 2: December 2007 Update