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)
If you do not specify the --user-regions=rum-sum
option, CALIPER_PMU_ENABLE()
and
CALIPER_PMU_DISABLE()
do not have any effect and the instructions behave as no-ops.
Metrics for Sorts/Cutoffs Specific to HP-UX
Here is additional information on "Metrics for Sorts/Cutoffs" specific to HP-UX.
The following additional report types support the use of the following metrics for sorting and applying
cutoffs, where the default metric for sorting is enclosed in [ ]:
acount arc-count,[taken-count ]
cgprof [samples], seconds, call-count ,
msecs-per-call
fcount
[call-count]
fcover address, name, reached-count
, reached-percent
, unreached-count
,
[
unreached-percent
]
Additional Environmental Variable on HP-UX
The following additional environment variable is available on HP-UX:
CALIPER_HOME Specifies the (non-default) caliper_root location when
caliper is automatically
invoked.
This is only needed when
caliper is not installed in its default location
(/opt/caliper ) and a program compiled with the +Oprofile=collect
option
(profile based optimization) is run.
Limitations
The current HP-UX version of
caliper has the following limitations:
• Only aggregated results can be produced for multi-threaded programs by the
acount, cgprof,
ecount, fcount, and fcover measurements.
• Handwritten assembly functions which do not follow the standard language runtime conventions may
not be properly measured for instrumentation-based reports:
acount, cgprof, fcount, and
fcover.
• Only native Itanium programs produced by the HP C, C++ and Fortran 9x compilers can be measured.
PA-RISC programs, although they can run on Itanium systems, cannot be measured.
• The option --scope=system is only supported on HP-UX B.11.23.0409 or later.
• The option --scope=system can not be used while any other PMU measurement is running on the
system.
• The option --scope=system can only be used by privileged users, unless this security measure is
disabled by setting the kernel tunable perfmon_allow_user_per_cpu
to the value 1.
• DLKM components are only listed if the user is privileged. Function-level information is not available
for those modules.
LINUX
--kernel-path There is no default kernel path used when sampling is done while in kernel mode. By
default, only kernel module and function information is produced for samples; this
option must be used to display disassembled instructions for kernel modules.
Limitations:
The current Linux version of caliper has the following limitations:
• Correlating sample data to source files created with GNU compilers requires debug information created
with the -g compiler option.
EXAMPLES
Here are some examples of common uses of caliper:
caliper ecount program
This will run program, measuring and reporting the total number of Itanium instructions executed
(IA64_INST_RETIRED), the total number of nops executed (NOPS_RETIRED) and the total number
of CPU cycles expended (CPU_CYCLES).
110 Hewlett-Packard Company − 20 − HP-UX 11i Version 2: December 2007 Update