caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
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).
caliper pmu_trace --sampling-spec=10000,0,CPU_CYCLES
program
This will run program, measuring and reporting the number of Itanium instructions executed
(IA64_INST_RETIRED), the number of nops executed (NOPS_RETIRED) and the number of CPU
cycles (CPU_CYCLES) every 10,000 cpu cycles (with no sampling variation. The
pmu_trace
measurement default is to sample every 50,000,000 cpu cycles.
CALIPER_OPTS="--module-exclude=/usr/lib/" caliper fprof
program
This will run program, measuring and reporting a flat profile of sampled instruction addresses,
excluding all system libraries.
caliper cstack program
This will run program, measuring and reporting a call stack profile by periodically sampling the
application program counter and each of its thread’s call stacks.
caliper cstack -e o 12345
This will attach to the specified process 12345 and generate a pstacklikereport.
caliper report --detail=0 fprof
This will re-report the last fprof measurement run with all functions included in the report (no
matter how little CPU time they used).
caliper info --detail=all L2
This will produce an information report including all details on all cpu events with "L2" in name.
caliper info -r itlb
This will produce an information report on the itlb measurement report.
caliper scgprof -w -e10
This will collect all activity across all CPUs in the system for a duration of 10 seconds, producing a
sample-based call graph report.
caliper fprof -s 500000,,CPU_CYCLES -s 500000,,IA64_INST_RETIRED a.out
This will collect IP samples on 2 different PMU events (for every 500000 CPU_CYCLES and for
every 500000 retired instructions). In the generated fprof report, the IP samples will be reported in
individual columns.
This is an example for simultaneous
fprof sampling on multiple PMU events.
caliper ecount -pall \
sh -c ’/usr/bin/ls; /usr/bin/echo done’
This will measure /usr/bin/sh, /usr/bin/ls, and /usr/bin/echo executions.
caliper ecount --process=ls:echo \
sh -c ’/usr/bin/ls; /usr/bin/echo done’
HP-UX 11i Version 3: September 2010 − 23 − Hewlett-Packard Company 23