HP Caliper User's Guide

cstack Measurement Report Description
With the cstack measurement, produced by the cstack measurement configuration
file, HP Caliper measures and reports a sampled call stack profile, produced by
periodically sampling the application program counter and each of its thread's call
stacks. It also measures and reports the blocking primitives that are responsible for the
blocked samples.
Example Command Line for Text Report
$ /opt/caliper/bin/caliper cstack -o results.txt ehh_thr_mutex1
Example Command Line for CSV Report
$ caliper cstack --csv results.csv enh_thr_mutex1
cstack Measurement Report Metrics
Table B-8 “Information in cstack Measurement Report Fields (Flat Profile)” shows the
information found in the flat profile part of a Call Stack Profile report.
In this table, “program object” refers to any of the following:
• Process summary
• Load module
• Function
• Source statement
• Instruction bundle
Table B-8 Information in cstack Measurement Report Fields (Flat Profile)
DescriptionColumn
Percentage of direct sample hits attributable to a given program object; run and
blocked hits combined.
% Total IP
Samples
Cumulative percentage of direct sample hits attributable to a given program object;
run and blocked hits combined.
Cumulat % of
Total
Total number of direct sample hits attributed to the given object; run. and blocked
hits combined
IP Samples
(HP-UX only)
Number of direct sample hits taken when the process was running, attributed to the
given object.
Sample Hits
Running
(HP-UX only)
Number of direct sample hits taken when a thread was waiting, (blocked or spinning)
on a thread level blocking primitive (mutex, read/write lock, or condition variable)
or process level blocking primitive (semaphore, message queue, socket, pipe, file
descriptor).
Sample Hits
Waiting
(HP-UX only)
240 Descriptions of Measurement Reports