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)
Common Measurements
cpu cpu execution statistics
cstack sampled call stack profile
dcache/icache cache miss profiles
ecount total cpu event counts
fprof flat execution profile
scgprof sampled call graph profile
Common Options
Save measurement results to named database:
-d DATABASE
Set length of measurement (in seconds):
-e ELAPSED_TIME
Specify which cpu metric sets to measure:
-m EVENT_SET[:all|:user|
:kernel][,EVENT_SET]...
where: EVENT_SET is:
overview|cpi|fp|l1dcache|l1icache|l2cache|l3cache|stall|
threadswitch
Specify which cpu events to measure:
-m CPU_EVENT[:EVENT_PARAM]...[
,CPU_EVENT]...
Save textual performance report to file:
-o TEXT_FILE
Selectively measure application processes:
-p {all|root|root-forks|PATTERN[,
PATTERN]...}
Control reporting details:
-r [all|none]
Control the sampling specification for profiles:
-s PERIOD[,VARIATION[,CPU_EVENT]]
Measure all threads individually:
-t
Perform measurement system wide (not on specific processes):
-w
Get help:
-h for short help
-H for full help
General Description
The caliper command measures, reports on, and analyzes the performance of native Itanium programs.
To obtain performance data, caliper measures some metrics using the Itanium’s Performance Monitor-
ing Unit (PMU) and, on some platforms, measures other metrics by inserting probe code into the running
program. No special preparation of the measured program is necessary.
caliper is available on HP-UX 11i v2 and later and Linux/Itanium (2.6.5 kernel and later). Note that
not all features are available on all platforms; see the PLATFORM-SPECIFIC ADDENDA section below for
details.
caliper operates in one of two broad collection modes: in per-process mode (using --scope=process)or
in system-wide mode (using --scope=system).
In per-process mode, caliper tracks and measures individual processes, optionally following fork and
exec calls.
In system-wide mode, caliper measures data across all CPUs on the system, and then attributes sam-
ples to individual processes. Using system-wide mode is a good way of understanding the broad
92 Hewlett-Packard Company − 2 − HP-UX 11i Version 2: December 2007 Update