HP UX Caliper Software manual 7

HP Caliper Environment Variables...........................................................................................	103
9 Controlling the Content of Reports.............................................................	104
Layout of an HP Caliper Text or CSV Report.............................................................................	104
Metrics You Can Use for Report Sorting and Cutoffs..................................................................	105
Module-Centric Reports.........................................................................................................	107
Process Summary.................................................................................................................	108
Function Details....................................................................................................................	109
Disassembly Listing...............................................................................................................	109
Branch Targets in Disassembly Listings................................................................................	110
Source Position Correlation....................................................................................................	110
Source Line Data.............................................................................................................	110
Address Types Shown............................................................................................................	110
How Functions Are Named in Reports.....................................................................................	111
Unnamed Functions..........................................................................................................	111
Unknown Functions..........................................................................................................	111
VSE Information Shown in Report Output (HP-UX only) ..................................................	111
HyperThreading Information for Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processors Shown
in Report Output...................................................................................................................	112
How HP Caliper Saves Data in Databases...............................................................................	113
Names and Locations for the Databases.............................................................................	113
Changing the Default Name and Location......................................................................	113
Creating Reports from Multiple Databases...............................................................................	114
Using the caliper report Command to Create a Report from One or More Databases................	115
Using the caliper merge Command to Merge Data From Multiple Collection Runs....................	115
Using the caliper diff Command to Difference Data Collected in Two Databases......................	117
Example of How to Use the caliper diff Command...........................................................	119
10 Producing a Sampled Call Graph Profile Analysis.....................................	120
How Sampled Call Graph Profile Analysis Works.....................................................................	120
Differences Between scgprof and cgprof..................................................................................	120
Running the HP Caliper Sampled Call Graph Profile..................................................................	121
Sampled Call Graph Text Report Example ...............................................................................	121
Sampled Call Graph Profile Report Details...............................................................................	130
Flat Profile Part of the Report..............................................................................................	130
Call Graph Part of the Report............................................................................................	130
Hot Call Paths Part of the Report........................................................................................	130
Function Indexes..............................................................................................................	130
Diagnostic Messages........................................................................................................	131
gprof Fallacy and Possibly Misleading Results...........................................................................	131
11 Producing a Sampled Call Stack Profile Analysis.......................................	132
Running HP Caliper to Produce a Call Stack Profile...................................................................	132
Call Stack Profile Text Report Example for HP-UX.......................................................................	132
Call Stack Profile Text Report Example for Linux........................................................................	140
Call Stack Profile Report Details..............................................................................................	147
Flat Profile Part of the Report..............................................................................................	147
Blocking Primitives Summary Part of the Report....................................................................	147
Thread Synchronization Primitive's Holder and Waiter Thread Analysis (HP-UX 11.31 only)....	147
Hot Call Paths Part of the Report........................................................................................	148
Call Graph Part of the Report............................................................................................	149
Function Indexes..............................................................................................................	149
Avoids gprof Fallacy.............................................................................................................	149

Contents 7