Metrics You Can Use for Report Sorting and Cutoffs..................................................................

106

Module-Centric Reports.........................................................................................................

109

Process Summary.................................................................................................................

110

Function Details....................................................................................................................

111

Disassembly Listing...............................................................................................................

111

Branch Targets in Disassembly Listings................................................................................

112

Source Position Correlation....................................................................................................

112

Source Line Data.............................................................................................................

112

Address Types Shown............................................................................................................

112

How Functions Are Named in Reports.....................................................................................

113

Unnamed Functions..........................................................................................................

113

Unknown Functions..........................................................................................................

113

VSE Information Shown in Report Output (HP-UX only) ..................................................

113

HyperThreading Information for Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processors Shown

in Report Output...................................................................................................................

114

How HP Caliper Saves Data in Databases...............................................................................

115

Names and Locations for the Databases.............................................................................

115

Changing the Default Name and Location......................................................................

115

Creating Reports from Multiple Databases...............................................................................

116

Using the caliper report Command to Create a Report from One or More Databases................

117

Using the caliper merge Command to Merge Data From Multiple Collection Runs....................

117

Using the caliper diff Command to Difference Data Collected in Two Databases......................

119

Example of How to Use the caliper diff Command...........................................................

121

10 Producing a Sampled Call Graph Profile Analysis.....................................

122

How Sampled Call Graph Profile Analysis Works.....................................................................

122

Differences Between scgprof and cgprof..................................................................................

122

Running the HP Caliper Sampled Call Graph Profile..................................................................

123

Sampled Call Graph Text Report Example ...............................................................................

123

Sampled Call Graph Profile Report Details...............................................................................

132

Flat Profile Part of the Report..............................................................................................

132

Call Graph Part of the Report............................................................................................

132

Hot Call Paths Part of the Report........................................................................................

132

Function Indexes..............................................................................................................

132

Diagnostic Messages........................................................................................................

133

gprof Fallacy and Possibly Misleading Results...........................................................................

133

11 Producing a Sampled Call Stack Profile Analysis.......................................

134

Running HP Caliper to Produce a Call Stack Profile...................................................................

134

Call Stack Profile Text Report Example for HP-UX.......................................................................

134

Call Stack Profile Text Report Example for Linux........................................................................

142

Call Stack Profile Report Details..............................................................................................

149

Flat Profile Part of the Report..............................................................................................

149

Blocking Primitives Summary Part of the Report....................................................................

149

Thread Synchronization Primitive's Holder and Waiter Thread Analysis (HP-UX 11.31 only)....

149

Hot Call Paths Part of the Report........................................................................................

150

Call Graph Part of the Report............................................................................................

151

Function Indexes..............................................................................................................

151

Avoids gprof Fallacy.............................................................................................................

151

Limitations to Using cstack.....................................................................................................

151

Pstack like functionality..........................................................................................................

151

12 Performing CPU Metrics Analysis (HP-UX only) ................................

153

13 HP Caliper Features Specific to HP-UX(HP-UX only) .........................

154

Measuring Memory Usage Concurrently with Other Measurements (HP-UX only) ....................

154

Examples of the --memory-usage= Option............................................................................

155

Contents 7