caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(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]]
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 and Itanium(R) 2
programs. To obtain performance data, caliper measures some metrics using the Itanium’s Perfor-
mance Monitoring 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 perfor-
mance picture on a system, before "drilling down" using caliper in per-process mode.
caliper can measure programs which are built 32-bit or 64-bit, shared bound or minshared bound,
optimized or debug. Applications can be written in C, C++, Fortran 9x, assembly (if standard runtime
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010