Descriptions of Measurement Reports 168 | HP UX Caliper Software

Limitations to Using cstack	149
Pstack like functionality	149
12 Performing CPU Metrics Analysis (HP-UX only)	151
13 HP Caliper Features Specific to HP-UX(HP-UX only)	152
Measuring Memory Usage Concurrently with Other Measurements (HP-UX only)	152
Examples of the --memory-usage= Option	153
Example Report Output	154
How to Read the Reports	154
System Memory Configuration Table	154
Process Memory Usage Table	155
Measuring System Usage Concurrently with Other Measurements (HP-UX only)	156
Example Report Output	156
Interpreting the Data	158
Attaching to a Running Process to Perform Precise Measurements (HP-UX only)	158
Taking PMU Samples in Your Code (HP-UX only)	159
Triggering PMU Samples in Specific Code Regions	159
Precautions When Using Triggered Samples	160
Restricting PMU Measurements to Specific Code Regions	161
A HP Caliper Diagnostic and Warning Messages	164
ERROR #28: Caliper Invalid Measurement Combination	164
Instructions Labeled STUB	164
Mispredicted Branches	164
PMU Sample Hits Outside Function Range	166
scgprof Reports Require Kernel Patch (HP-UX only)	166
B Descriptions of Measurement Reports	168
alat Measurement Report Description	168
Example Command Line for Text Report	168
Example Command Line for CSV Report	168
alat Metrics Summed for Entire Run	169
Metrics for Integrity Servers Itanium 2 Systems	169
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	169
alat Measurement Report Metrics	170
How ALAT Metrics Are Obtained	171
branch Measurement Report Description	171
Example Command Line for Text Report	172
Example Command Line for CSV Report	172
branch Metrics Summed for Entire Run	172
Metrics for Integrity Servers Itanium 2 Systems	172
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	172
branch Measurement Report Metrics	174
How branch Metrics Are Obtained	175
cgprof Report Description (HP-UX only)	175
Example Command Line for Text Report	175
Example Command Line for CSV Report	175
HP Caliper Call Graph Profile Results Accuracy	176
Call Graph Profile Metrics	176

8Contents

Image 8

HP UX Caliper Software manual HP Caliper Diagnostic and Warning Messages 164, Descriptions of Measurement Reports 168

Contents

HP Caliper User Guide Copyright 2011 Hewlett-Packard Development Company, L.P Contents Remote GUI HP Caliper Measurement Configuration FilesHP Caliper Options Contents Using the HP Caliper Advisor Using the HP Caliper Advisor in the GUIConfiguring HP Caliper Threads Traps-reported User-regionsHP-UX only Version Controlling the Content of Reports 104 Producing a Sampled Call Graph Profile Analysis 120Producing a Sampled Call Stack Profile Analysis 132 HP Caliper Environment Variables 103 Descriptions of Measurement Reports 168 HP Caliper Diagnostic and Warning Messages 164Limitations to Using cstack 149 Pstack like functionality Contents Event Set Descriptions for CPU Metrics HP-UX only 219 Glossary 253 Index 258 About This Document Command Typographic ConventionsComputer output File name Related Documents HP Encourages Your Questions HP Caliper at a Glance What Is HP Caliper?HP Caliper at a Glance What Is HP Caliper? HP Caliper Components User Interfaces Supported Compilers and Application Environments What Does HP Caliper Run On?Supported Hardware and Operating Systems Summary of HP Caliper Features Summary of HP Caliper Features Getting Started with the HP Caliper Command-Line Interface Getting Started with the HP Caliper Command-Line Interface PLM Target Page Example Adding Instructions to an fprof Report Example Adding Instructions to an fprof Report Types of Measurements Global MeasurementSampled Measurements Precise Measurements What to Look for in Using HP Caliper Syntax for caliper CommandCaliper measurement caliperoptions program programarguments Measurement Basic Tasks a Quick Reference Starting HP CaliperStopping HP Caliper Showing HP Caliper Options Using the HP Caliper Advisor Restrictions on Using HP CaliperCreating a Text Report for Analysis Creating a Report Based on Your Collected Data Additional HP Caliper Commands Getting Information About HP CaliperCaliper info Caliper report merge diff What Is the HP Caliper GUI? What Is the HP Caliper GUI?Getting Started with the HP Caliper GUI Window Basics Projects View Getting Started with the HP Caliper GUI Collect View Window Basics Analyze View Collect View Advisor View Analyze View Console View Advisor View Diagnostics View Help View Making Measurements Tips for Using ViewsHints on How to Make Measurements Exploring Performance Data Getting Performance Tuning AdviceExploring Performance Data Getting Help Starting the GUINative Local GUI Remote GUI Login Screen Starting the GUI HP Caliper Measurement Configuration Files Measurement Configuration Files Provided with HP Caliper Dtlb EcountFprof Icache Global Sampled Overview MeasurementAvailable Measurements in Each Measurement Type Simultaneous fprof Sampling on Multiple PMU Counters Location of Measurement Configuration FilesSimultaneous fprof Sampling on Multiple PMU Counters See Hierarchy for Processing an Option Value p Specifying Option Values in Measurement Configuration FilesYou are free to rename measurement configuration files HP Caliper Options Basic Information About OptionsMultiple Ways to Specify HP Caliper Option Values Examples Or --database Or --durationHierarchy for Processing an Option Value Examples Or --options-file Or -?Or --help Or --metrics Or --output-file Cpuevent For PMU Histogram Reports Or --processOr --report-details Or --sampling-spec For Function Coverage ReportsSperiod Srate ,variation ,cpuevent Rate Default value is 5 percent Or --versionCPUCYCLES,10000,10% Branchevent Advice-classes Advice-cutoffAdvice-details Analysis-focus Bus-speed Callpath-cutoffBus-speed int Callpath-cutoffpercentcutoff,cumpercentcutoff,mincount Context-lines Cpu-aggregationCpu-counter Cpu-details Csv-file Dcache-data-profileDatabase Dbrp Db-save Description-detailsDetails Detail-cutoff Example Etb-freeze-delayDuration Event-defaults Event-defaults privilege-level-mask=levelthreshold=intEtb-walkback-cycles Etb-walkback-cycles integer Exclude-caliper Exclude-idleFold Frame-depth Help HotpathsIbrp Info Join JreKernel-path Kernel-stack Latency-buckets Measure-on-interruptsMemory-usage= Metrics Module-default Module-excludeModule-include Module-search-path Noinlines OmrOptions-file Output-file Per-module-data Percent-columnsPercent-sample Prim-cutoff Process Process-cutoffSee -p or --process p Process-cutoffpercentcutoff,cumpercentcutoff,mincount Read-init-file ReportReport-details Rule-files Using --scope system for System-Wide Measurements Psetid psetid Search Skip-functionsSort-by Sort-bymetric,cpuevent Source-path-map Stop-functionsSummary-cutoff Summary-cutoffpercentcutoff,cumpercentcutoff,mincount System-model Linux only System-usage=Term-display System-modelmodel-number,number-of-cells User-regions ThreadsTraps-reported Version VersionSee -v or --version p Using the HP Caliper Advisor What Is the HP Caliper Advisor?Example of an HP Caliper Advisor Report Limitations to Keep in Mind Example 1 HP Caliper Advisor Report Steps in Using the AdvisorSteps in Using the Advisor Where adviseoptions are Command Line to Invoke the AdvisorCommand line is Advice-classes Advice-cutoffAdvice-details Max-count More Typical Examples Getting Started with the Advisor ExamplesSimplest Example Then, run the Advisor on the composite performance data Explanation of Report OutputFollowed by How to Read an Advisor Report Suggestions for Using the HP Caliper Advisor Suggestions for Using the HP Caliper Advisor How the HP Caliper Advisor Works Using the HP Caliper Advisor in the GUI Basic Steps in Using the HP Caliper Advisor in the GUIBasic Steps in Using the HP Caliper Advisor in the GUI Making Performance Measurement Runs Using the HP Caliper Advisor in the GUI Selecting Performance Data to Analyze Optional Projects View, with a Single Project Selected Selecting Performance Data to Analyze Optional Generating Advice Projects View, with a Single Measurement Run Selected Reviewing and Acting on the Advice Reviewing and Acting on the Advice Advisor Report in the HP Caliper GUI Caliperinit file, you can then simply type Configuring HP CaliperExample of a .caliperinit File Setting Constants in the .caliperinit File Disasmtargetnamelimit = limitSuppressinitwarnings = TrueFalse Suppressstatementdata = TrueFalse Configuring Data Collection Configuring Data CollectionSpecifying Which CPU Events to Measure Shortening CPU Event Names Module-default Module-include Module-exclude Specifying Which Load Modules to Collect Data ForModule-include modulelist Module-exclude modulelist Default Settings for Load Module Data Collection How to Specify Load Module Names Controlling Granularity of Data Collection and Reports Specifying Processes to MeasureProcess Tree Report For more information, see -s or --sampling-spec p Default Syntax for -p OptionRoot-forks Customfunctionname Someopt1,opt2,...pattern Using -p someSome opt1,... pattern Glob1 glob2 Examples of the -p Option Process Origin Options Used with -p someTo measure only ecom and ld Reports information for cc root, cc fork, cc fork, ctcom Using HP Caliper in Your Build Process Using HP Caliper in Testing and Quality AssuranceUsing HP Caliper to Generate Test Suite Reports Attaching to a Running Process to Perform Measurements Options for the caliper info Command Example Output of the caliper info Command Examples of the caliper info Command HP Caliper Environment Variables Layout of an HP Caliper Text or CSV Report Controlling the Content of ReportsControlling the Content of Reports Metrics You Can Use for Report Sorting and Cutoffs Metrics You Can Use for Report Sorting and Cutoffs Available Metrics for Report Sorting and Cutoffs This produces a report similar to this truncated report Module-Centric ReportsFor example, assume that you perform this HP Caliper run Process Summary for a Diff Run Process SummaryProcess Summary for a --group-by none Run Function Details Disassembly ListingFunction Details Branch Targets in Disassembly Listings Source Position CorrelationAddress Types Shown Source Line Data How Functions Are Named in Reports VSE Information Shown in Report OutputUnnamed Functions Unknown Functions Controlling the Content of Reports Changing the Default Name and Location How HP Caliper Saves Data in DatabasesNames and Locations for the Databases Or simply You can use the caliper report merge diff command to Where reportoptions is one or more of these optionsCreating Reports from Multiple Databases Caliper report merge diff reportoptions databases Databases is one of these Database2 database1 for caliper diffCaliper report reportoptions database Caliper merge reportoptions database1 database2 Example 2 Example of a caliper merge Run Cpucycles Pmutrace Scgprof Caliper diff reportoptions database2 database1 Example 3 Example of a caliper diff Run Example of How to Use the caliper diff Command Cstack Pmutrace ScgprofAs cc1 ld As cc1 Producing a Sampled Call Graph Profile Analysis How Sampled Call Graph Profile Analysis WorksDifferences Between scgprof and cgprof Producing a Sampled Call Graph Profile Analysis Running the HP Caliper Sampled Call Graph Profile Sampled Call Graph Text Report ExampleCaliper scgprof caliperoptions program programarguments Running the HP Caliper Sampled Call Graph Profile Sampled Call Graph Text Report Example Sampled Call Graph Text Report Example Producing a Sampled Call Graph Profile Analysis Br.cond.dpnt.many self+0x2db0 Producing a Sampled Call Graph Profile Analysis Sampled Call Graph Text Report Example Producing a Sampled Call Graph Profile Analysis Root Sampled Call Graph Profile Report Details Flat Profile Part of the ReportCall Graph Part of the Report Hot Call Paths Part of the Report Diagnostic Messages Diagnostic Messages appear at the end of the reportGprof Fallacy and Possibly Misleading Results Gprof Fallacy and Possibly Misleading Results Producing a Sampled Call Stack Profile Analysis Running HP Caliper to Produce a Call Stack ProfileCall Stack Profile Text Report Example for HP-UX Caliper cstack caliperoptions program programarguments Call Stack Profile Text Report Example Call Stack Profile Text Report Example for HP-UX Producing a Sampled Call Stack Profile Analysis Call Stack Profile Text Report Example for HP-UX Root Call Stack Profile Text Report Example for HP-UX Producing a Sampled Call Stack Profile Analysis Function Indexes Thread 6065598@startroutine Name Call Stack Profile Text Report Example for Linux An example report for HP Caliper on Linux is shown here Call Stack Profile Text Report Example for Linux Call Stack Profile Text Report Example for Linux Producing a Sampled Call Stack Profile Analysis Root Producing a Sampled Call Stack Profile Analysis Call Stack Profile Text Report Example for Linux Producing a Sampled Call Stack Profile Analysis Call Stack Profile Report Details Blocking Primitives Summary Part of the ReportSamples-running HP-UX only Samples-blocked HP-UX only Call Stack Profile Report Details Example 4 Sample cstack Report Blocking Primitives Details Limitations to Using cstack Avoids gprof FallacyPstack like functionality Sample report follows Producing a Sampled Call Stack Profile Analysis Performing CPU Metrics Analysis 151 HP Caliper Features Specific to HP-UX Measuring Memory Usage Concurrently with Other Measurements Examples of the --memory-usage= Option Example Report Output How to Read the ReportsSystem Memory Configuration Table Process Memory Usage Table Measuring System Usage Concurrently with Other Measurements Example System Usage Report Output Measuring System Usage Concurrently with Other Measurements Interpreting the Data Caliper measurement options pid Taking PMU Samples in Your Code Triggering PMU Samples in Specific Code RegionsRun ./myprog and find the process ID of the process Taking PMU Samples in Your Code Precautions When Using Triggered Samples 160 shows part of the resulting report Restricting PMU Measurements to Specific Code Regions Caliperpmuenable Restricting PMU Measurement to Specific Code HP Caliper Diagnostic and Warning Messages Error #28 Caliper Invalid Measurement CombinationHP Caliper Diagnostic and Warning Messages Instructions Labeled Stub Mispredicted Branches Example Mispredicted Branches PMU Sample Hits Outside Function Range Scgprof Reports Require Kernel Patch Scgprof Reports Require Kernel Patch Example Command Line for Text Report Example Command Line for CSV ReportDescriptions of Measurement Reports Alat Measurement Report Description Alat Metrics Summed for Entire Run Metrics for Integrity Servers Itanium 2 Systems Alat Measurement Report Metrics INSTCHKALDCALAT.FPINSTCHKALDCALAT.INT INSTFAILEDCHKALDCALAT.FP Information in alat Measurement Reports Branch Measurement Report DescriptionHow Alat Metrics Are Obtained Branch Metrics Summed for Entire Run BRMISPREDDETAIL.NRETIND.WRONGPATH BRMISPREDDETAIL.NRETIND.WRONGTARGETBRMISPREDDETAIL.RETURN.CORRECTPRED BRMISPREDDETAIL.RETURN.WRONGPATH Branch Measurement Report Metrics Information in branch Measurement Reports Cgprof Report Description How branch Metrics Are ObtainedAvailable only on HP-UX For rows showing instructions on a bundle boundary Profiled otherwise blank HP Caliper Call Graph Profile Results AccuracyCall Graph Profile Metrics Information in cgprof Measurement Report Parent Listings Cpu Measurement Report Description Information in cgprof Measurement Report Children ListingsColumn Description Func Hits In Children This child entry Example Command Lines for Text Report CPU Event Sets Dspec L1dcacheL1icache L2cache Threadswitch Cstack Measurement Report DescriptionCstack Measurement Report Metrics Sysbus Be resolved to a symbol Column Description Total Hits WaitingMessage queue, socket, pipe, file descriptor Semaphore, message queue, socket, pipe, file descriptor Cycles Measurement Report Description Parent Func HitsChildren Cycles Measurement Report Description Cycles Metrics Summed for Entire Run Cycles Measurement Metrics Information in cycles Measurement Reports How cycles Metrics Are Obtained From that bundle are split issuedDcache Measurement Report Description L1DREADMISSES.ALL Dcache Metrics Summed for Entire RunL1DREADS L2DMISSES DatareferencesL2DINSERTMISSES Dcache Measurement Report Metrics L2DREFERENCES.ALLInformation in dcache Measurement Reports Cycles Object Avg. Dcache Example dcache Reports Dcache Measurement Report Description How Data Cache Metrics Are Obtained Dtlb Measurement Report Description How Latency Bucket Metrics Are ObtainedHow the Data Summary Information Is Obtained Dtlb Measurement Report Description Dtlb Metrics Summed for Entire Run L2DTLBMISSESDtlbinsertshpw L2DTLBMISSES / Datareferences Dtlb Measurement Report Metrics Cycles lost due to all stalls lower is better Information in dtlb Measurement Reports How Data TLB Metrics Are ObtainedFunction Source statement Instruction Ecount Measurement Report Description Ecount Metrics Summed for Entire RunCpucycles Ecount Measurement Report Description Descriptions of Measurement Reports Fcount Measurement Report Description Fcover Measurement Report DescriptionFcount Measurement Report Metrics Fcover Measurement Report Metrics Fprof Measurement Report Description Unknown Source FilesDirectory Function Fprof Metrics Summed for Entire Run Number of elapsed processor cyclesFull pipe bubbles in main pipe Fprof Measurement Report Description Fprof Measurement Metrics How fprof Metrics Are Obtained Information in fprof Measurement Reports Icache Measurement Report Description Icache Metrics Summed for Entire RunL1IREADS L2INSTDEMANDREADS L1IPREFETCHES Information in icache Measurement Reports Icache Measurement Report MetricsThat are misses Function Details How Instruction Cache Metrics Are Obtained Itlb Measurement Report Description Itlb Metrics Summed for Entire RunITLBMISSESFETCH.L1ITLB ITLBMISSESFETCH.L2ITLB Itlb Measurement Report Description Itlb Measurement Report MetricsBELOSTBWDUETOFE.IMISS Function Statement Cache line Information in itlb Measurement Reports Pmutrace Measurement Report Description Scgprof Measurement Report DescriptionHow Instruction TLB Metrics Are Obtained Pmutrace Measurement Report Description Is profiled otherwise blank Scgprof Measurement Report Metrics Flat ProfileScgprof Measurement Report Metrics Call Graph Profile Information in scgprof Measurement Report Parent Listings Scgprof Measurement Report Description Traps Measurement Report Description Vfault DarghtDbit Debug Traps Metrics Summed for Entire Run Information in traps Measurement Reports Traps Measurement MetricsCycles lost due to RSE stalls How traps Metrics Are Obtained Event Set Descriptions for CPU Metrics Brpath Event SetMetrics Available from this Measurement Include idle --exclude-idle False Brpred Event Set Event Set Descriptions for CPU Metrics Iprel Brpred Event Set C2c Event Set Cpi Event Set Cpi Event Set Mips Pred-OffCPI Cpubus Event Set Cpubus Event SetAvailable only on Itanium 2 and dual-core Itanium 2 systems Cspec Event Set Dispersal Event Set Dispersal Event Set Dspec Event Set Dspec Event Set Fp Event Set FCVT.fx SIR Fp Event Set L1dcache Event Set L1icache Event Set L1icache Event SetNON RSE Misses per Kinst Metrics Available from this Measurement L2cache Event Set L2cache Event Set Metrics Available from this Measurement L2dcache Event Set L2dcache Event Set L2icache Event Set L2icache Event Set L3cache Event Set L3cache Event Set Memreq Event Set Queues Event Set Queues Event Set Snoop Event Set Stall Event Set Stall Event Set Metrics Available from this Measurement Sysbus Event Set Sysbus Event Set Bril CPUBRL Threadswitch Event Set BWLBRC BIL Tlb Event Set Tlb Event Set Event Set Descriptions for CPU Metrics Glossary 253 Set p Glossary Hot spot 255 Nop Measurements p 257 Symbols Index 259 CPU event names shortening, 93 CPU eventsDaemon processes measuring Environment variables HP Caliper, 103 Error messages Sampled measurements performing 261 Useparensforstatementdata constant