Contents | HP UX Caliper Software guide

cpu Measurement Report Description (HP-UX only)	178
Example Command Lines for Text Report	179
Example Command Line for CSV Report	179
CPU Event Sets	179
cstack Measurement Report Description	181
Example Command Line for Text Report	181
Example Command Line for CSV Report	181
cstack Measurement Report Metrics	181
cycles Measurement Report Description	183
Example Command Line for Text Report	184
Example Command Line for CSV Report	184
cycles Metrics Summed for Entire Run	184
cycles Measurement Metrics	185
How cycles Metrics Are Obtained	186
dcache Measurement Report Description	186
Example Command Line for Text Report	187
Example Command Line for CSV Report	187
dcache Metrics Summed for Entire Run	187
Metrics for Integrity Servers Itanium 2 Systems	187
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	188
dcache Measurement Report Metrics	189
Example dcache Reports	190
Using the --dcache-data-profile Option to Produce a Data Summary	191
How Data Cache Metrics Are Obtained	192
How Latency Bucket Metrics Are Obtained	193
How the Data Summary Information Is Obtained	193
dtlb Measurement Report Description	193
Example Command Line for Text Report	193
Example Command Line for CSV Report	194
dtlb Metrics Summed for Entire Run	194
Metrics for Integrity Servers Itanium 2 Systems	194
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	194
dtlb Measurement Report Metrics	195
How Data TLB Metrics Are Obtained	196
ecount Measurement Report Description	197
Example Command Line for Text Report	197
Example Command Line for CSV Report	197
ecount Metrics Summed for Entire Run	197
Metrics for Integrity Servers Itanium 2 Systems	197
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	198
fcount Measurement Report Description (HP-UX only)	199
Example Command Line for Text Report	199
Example Command Line for CSV Report	199
fcount Measurement Report Metrics	199
fcover Measurement Report Description (HP-UX only)	199
Example Command Line for Text Report	199
Example Command Line for CSV Report	199
fcover Measurement Report Metrics	199
Unknown Source Files	200
-r for Function Coverage Reports	200
fprof Measurement Report Description	200
Example Command Line for Text Report	201

Contents 9

Image 9

HP UX Caliper Software manual Contents

Contents

HP Caliper User Guide Copyright 2011 Hewlett-Packard Development Company, L.P Contents HP Caliper Measurement Configuration Files HP Caliper OptionsRemote GUI Contents Using the HP Caliper Advisor in the GUI Using the HP Caliper AdvisorConfiguring HP Caliper Threads Traps-reported User-regionsHP-UX only Version Producing a Sampled Call Graph Profile Analysis 120 Controlling the Content of Reports 104Producing a Sampled Call Stack Profile Analysis 132 HP Caliper Environment Variables 103 HP Caliper Diagnostic and Warning Messages 164 Limitations to Using cstack 149 Pstack like functionalityDescriptions of Measurement Reports 168 Contents Event Set Descriptions for CPU Metrics HP-UX only 219 Glossary 253 Index 258 About This Document Typographic Conventions CommandComputer output File name Related Documents HP Encourages Your Questions What Is HP Caliper? HP Caliper at a GlanceHP Caliper at a Glance HP Caliper Components User Interfaces What Is HP Caliper? What Does HP Caliper Run On? Supported Hardware and Operating SystemsSupported Compilers and Application Environments 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 Global Measurement Types of MeasurementsSampled Measurements Precise Measurements Syntax for caliper Command What to Look for in Using HP CaliperCaliper measurement caliperoptions program programarguments Measurement Starting HP Caliper Basic Tasks a Quick ReferenceStopping HP Caliper Showing HP Caliper Options Restrictions on Using HP Caliper Using the HP Caliper AdvisorCreating a Text Report for Analysis Creating a Report Based on Your Collected Data Getting Information About HP Caliper Additional HP Caliper CommandsCaliper 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 Getting Started with the HP Caliper GUI Projects View Window Basics Collect View Collect View Analyze View Analyze View Advisor View Advisor View Console View Help View Diagnostics View Tips for Using Views Hints on How to Make MeasurementsMaking Measurements Getting Performance Tuning Advice Exploring Performance DataExploring Performance Data Starting the GUI Getting HelpNative Local GUI Remote GUI Starting the GUI Login Screen Measurement Configuration Files Provided with HP Caliper HP Caliper Measurement Configuration Files Ecount DtlbFprof Icache Overview Measurement Available Measurements in Each Measurement TypeGlobal Sampled Location of Measurement Configuration Files Simultaneous fprof Sampling on Multiple PMU CountersSimultaneous fprof Sampling on Multiple PMU Counters Specifying Option Values in Measurement Configuration Files You are free to rename measurement configuration filesSee Hierarchy for Processing an Option Value p Basic Information About Options HP Caliper OptionsMultiple Ways to Specify HP Caliper Option Values Examples Or --duration Or --databaseHierarchy for Processing an Option Value Examples Or -? Or --options-fileOr --help Or --metrics Cpuevent Or --output-file Or --process Or --report-detailsFor PMU Histogram Reports For Function Coverage Reports Or --sampling-specSperiod Srate ,variation ,cpuevent Rate Or --version Default value is 5 percentCPUCYCLES,10000,10% Branchevent Advice-cutoff Advice-classesAdvice-details Analysis-focus Callpath-cutoff Bus-speedBus-speed int Callpath-cutoffpercentcutoff,cumpercentcutoff,mincount Cpu-aggregation Context-linesCpu-counter Cpu-details Dcache-data-profile Csv-fileDatabase Dbrp Description-details Db-saveDetails Detail-cutoff Etb-freeze-delay DurationExample Event-defaults privilege-level-mask=levelthreshold=int Event-defaultsEtb-walkback-cycles Etb-walkback-cycles integer Exclude-idle Exclude-caliperFold Frame-depth Hotpaths HelpIbrp Info Jre JoinKernel-path Kernel-stack Measure-on-interrupts Latency-bucketsMemory-usage= Metrics Module-exclude Module-defaultModule-include Module-search-path Omr NoinlinesOptions-file Output-file Percent-columns Per-module-dataPercent-sample Prim-cutoff Process-cutoff ProcessSee -p or --process p Process-cutoffpercentcutoff,cumpercentcutoff,mincount Report Read-init-fileReport-details Rule-files Psetid psetid Using --scope system for System-Wide Measurements Skip-functions SearchSort-by Sort-bymetric,cpuevent Stop-functions Source-path-mapSummary-cutoff Summary-cutoffpercentcutoff,cumpercentcutoff,mincount System-usage= System-model Linux onlyTerm-display System-modelmodel-number,number-of-cells Threads Traps-reportedUser-regions Version See -v or --version pVersion What Is the HP Caliper Advisor? Using the HP Caliper AdvisorExample of an HP Caliper Advisor Report Limitations to Keep in Mind Steps in Using the Advisor Steps in Using the AdvisorExample 1 HP Caliper Advisor Report Command Line to Invoke the Advisor Command line isWhere adviseoptions are Advice-cutoff Advice-classesAdvice-details Max-count Getting Started with the Advisor Examples Simplest ExampleMore Typical Examples Explanation of Report Output Followed byThen, run the Advisor on the composite performance data 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 Basic Steps in Using the HP Caliper Advisor in the GUI Using the HP Caliper Advisor in the GUIBasic Steps in Using the HP Caliper Advisor in the GUI Making Performance Measurement Runs Selecting Performance Data to Analyze Optional Using the HP Caliper Advisor in the GUI Selecting Performance Data to Analyze Optional Projects View, with a Single Project Selected Projects View, with a Single Measurement Run Selected Generating Advice Reviewing and Acting on the Advice Reviewing and Acting on the Advice Advisor Report in the HP Caliper GUI Configuring HP Caliper Example of a .caliperinit FileCaliperinit file, you can then simply type Disasmtargetnamelimit = limit Setting Constants in the .caliperinit FileSuppressinitwarnings = TrueFalse Suppressstatementdata = TrueFalse Configuring Data Collection Configuring Data CollectionSpecifying Which CPU Events to Measure Shortening CPU Event Names Specifying Which Load Modules to Collect Data For Module-default Module-include Module-excludeModule-include modulelist Module-exclude modulelist How to Specify Load Module Names Default Settings for Load Module Data Collection Specifying Processes to Measure Controlling Granularity of Data Collection and ReportsProcess Tree Report For more information, see -s or --sampling-spec p Syntax for -p Option DefaultRoot-forks Customfunctionname Using -p some Some opt1,... pattern Glob1 glob2Someopt1,opt2,...pattern Process Origin Options Used with -p some Examples of the -p OptionTo measure only ecom and ld Reports information for cc root, cc fork, cc fork, ctcom Using HP Caliper in Testing and Quality Assurance Using HP Caliper in Your Build ProcessUsing HP Caliper to Generate Test Suite Reports Attaching to a Running Process to Perform Measurements Example Output of the caliper info Command Options for the caliper info Command Examples of the caliper info Command HP Caliper Environment Variables Controlling the Content of Reports Controlling the Content of ReportsLayout of an HP Caliper Text or CSV Report 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 Module-Centric Reports For example, assume that you perform this HP Caliper runThis produces a report similar to this truncated report Process Summary Process Summary for a --group-by none RunProcess Summary for a Diff Run Disassembly Listing Function DetailsFunction Details Source Position Correlation Branch Targets in Disassembly ListingsAddress Types Shown Source Line Data VSE Information Shown in Report Output How Functions Are Named in ReportsUnnamed Functions Unknown Functions Controlling the Content of Reports How HP Caliper Saves Data in Databases Changing the Default Name and LocationNames and Locations for the Databases Or simply Where reportoptions is one or more of these options You can use the caliper report merge diff command toCreating Reports from Multiple Databases Caliper report merge diff reportoptions databases Database2 database1 for caliper diff Databases is one of theseCaliper report reportoptions database Caliper merge reportoptions database1 database2 Cpucycles Example 2 Example of a caliper merge Run Caliper diff reportoptions database2 database1 Pmutrace Scgprof Example 3 Example of a caliper diff Run Cstack Pmutrace Scgprof Example of How to Use the caliper diff CommandAs cc1 ld As cc1 How Sampled Call Graph Profile Analysis Works Producing a Sampled Call Graph Profile AnalysisDifferences Between scgprof and cgprof Producing a Sampled Call Graph Profile Analysis Sampled Call Graph Text Report Example Running the HP Caliper Sampled Call Graph ProfileCaliper 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 Flat Profile Part of the Report Sampled Call Graph Profile Report DetailsCall Graph Part of the Report Hot Call Paths Part of the Report Diagnostic Messages appear at the end of the report Diagnostic MessagesGprof Fallacy and Possibly Misleading Results Gprof Fallacy and Possibly Misleading Results Running HP Caliper to Produce a Call Stack Profile Producing a Sampled Call Stack Profile AnalysisCall Stack Profile Text Report Example for HP-UX Caliper cstack caliperoptions program programarguments Call Stack Profile Text Report Example for HP-UX Call Stack Profile Text Report Example 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 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 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 Blocking Primitives Summary Part of the Report Call Stack Profile Report DetailsSamples-running HP-UX only Samples-blocked HP-UX only Call Stack Profile Report Details Example 4 Sample cstack Report Blocking Primitives Details Avoids gprof Fallacy Limitations to Using cstackPstack like functionality Sample report follows Producing a Sampled Call Stack Profile Analysis 151 Performing CPU Metrics Analysis Measuring Memory Usage Concurrently with Other Measurements HP Caliper Features Specific to HP-UX Examples of the --memory-usage= Option How to Read the Reports System Memory Configuration TableExample Report Output Process Memory Usage Table Measuring System Usage Concurrently with Other Measurements Measuring System Usage Concurrently with Other Measurements Example System Usage Report Output Caliper measurement options pid Interpreting the Data Triggering PMU Samples in Specific Code Regions Taking PMU Samples in Your CodeRun ./myprog and find the process ID of the process Taking PMU Samples in Your Code 160 shows part of the resulting report Precautions When Using Triggered Samples Restricting PMU Measurements to Specific Code Regions Caliperpmuenable Restricting PMU Measurement to Specific Code Error #28 Caliper Invalid Measurement Combination HP Caliper Diagnostic and Warning MessagesHP Caliper Diagnostic and Warning Messages Instructions Labeled Stub Mispredicted Branches Mispredicted Branches Example Scgprof Reports Require Kernel Patch PMU Sample Hits Outside Function Range Scgprof Reports Require Kernel Patch Example Command Line for CSV Report Example Command Line for Text ReportDescriptions of Measurement Reports Alat Measurement Report Description Metrics for Integrity Servers Itanium 2 Systems Alat Metrics Summed for Entire Run INSTCHKALDCALAT.FP Alat Measurement Report MetricsINSTCHKALDCALAT.INT INSTFAILEDCHKALDCALAT.FP Branch Measurement Report Description How Alat Metrics Are ObtainedInformation in alat Measurement Reports Branch Metrics Summed for Entire Run BRMISPREDDETAIL.NRETIND.WRONGTARGET BRMISPREDDETAIL.NRETIND.WRONGPATHBRMISPREDDETAIL.RETURN.CORRECTPRED BRMISPREDDETAIL.RETURN.WRONGPATH Information in branch Measurement Reports Branch Measurement Report Metrics How branch Metrics Are Obtained Cgprof Report DescriptionAvailable only on HP-UX For rows showing instructions on a bundle boundary HP Caliper Call Graph Profile Results Accuracy Call Graph Profile MetricsProfiled otherwise blank Information in cgprof Measurement Report Parent Listings Information in cgprof Measurement Report Children Listings Cpu Measurement Report DescriptionColumn Description Func Hits In Children This child entry CPU Event Sets Example Command Lines for Text Report L1dcache DspecL1icache L2cache Cstack Measurement Report Description ThreadswitchCstack Measurement Report Metrics Sysbus Column Description Total Hits Waiting Be resolved to a symbolMessage queue, socket, pipe, file descriptor Semaphore, message queue, socket, pipe, file descriptor Parent Func Hits Cycles Measurement Report DescriptionChildren Cycles Measurement Report Description Cycles Metrics Summed for Entire Run Information in cycles Measurement Reports Cycles Measurement Metrics From that bundle are split issued Dcache Measurement Report DescriptionHow cycles Metrics Are Obtained Dcache Metrics Summed for Entire Run L1DREADSL1DREADMISSES.ALL Datareferences L2DINSERTMISSESL2DMISSES L2DREFERENCES.ALL Dcache Measurement Report MetricsInformation in dcache Measurement Reports Cycles Object Avg. Dcache Example dcache Reports Dcache Measurement Report Description How Data Cache Metrics Are Obtained How Latency Bucket Metrics Are Obtained Dtlb Measurement Report DescriptionHow the Data Summary Information Is Obtained Dtlb Measurement Report Description L2DTLBMISSES Dtlb Metrics Summed for Entire RunDtlbinsertshpw L2DTLBMISSES / Datareferences Cycles lost due to all stalls lower is better Dtlb Measurement Report Metrics How Data TLB Metrics Are Obtained Function Source statement InstructionInformation in dtlb Measurement Reports Ecount Metrics Summed for Entire Run Ecount Measurement Report DescriptionCpucycles Ecount Measurement Report Description Descriptions of Measurement Reports Fcover Measurement Report Description Fcount Measurement Report DescriptionFcount Measurement Report Metrics Fcover Measurement Report Metrics Unknown Source Files Fprof Measurement Report DescriptionDirectory Function Number of elapsed processor cycles Fprof Metrics Summed for Entire RunFull pipe bubbles in main pipe Fprof Measurement Report Description Fprof Measurement Metrics Information in fprof Measurement Reports How fprof Metrics Are Obtained Icache Metrics Summed for Entire Run Icache Measurement Report DescriptionL1IREADS L2INSTDEMANDREADS L1IPREFETCHES Icache Measurement Report Metrics That are missesInformation in icache Measurement Reports How Instruction Cache Metrics Are Obtained Function Details Itlb Metrics Summed for Entire Run Itlb Measurement Report DescriptionITLBMISSESFETCH.L1ITLB ITLBMISSESFETCH.L2ITLB Itlb Measurement Report Metrics BELOSTBWDUETOFE.IMISSItlb Measurement Report Description Information in itlb Measurement Reports Function Statement Cache line Scgprof Measurement Report Description Pmutrace Measurement Report DescriptionHow Instruction TLB Metrics Are Obtained Pmutrace Measurement Report Description Scgprof Measurement Report Metrics Flat Profile Scgprof Measurement Report Metrics Call Graph ProfileIs profiled otherwise blank Scgprof Measurement Report Description Information in scgprof Measurement Report Parent Listings Traps Measurement Report Description Darght VfaultDbit Debug Traps Metrics Summed for Entire Run Traps Measurement Metrics Cycles lost due to RSE stallsInformation in traps Measurement Reports How traps Metrics Are Obtained Brpath Event Set Event Set Descriptions for CPU MetricsMetrics Available from this Measurement Include idle --exclude-idle False Event Set Descriptions for CPU Metrics Brpred Event Set Brpred Event Set Iprel C2c Event Set Cpi Event Set Cpi Event Set Pred-Off CPIMips Cpubus Event Set Available only on Itanium 2 and dual-core Itanium 2 systemsCpubus Event Set Cspec Event Set Dispersal Event Set Dispersal Event Set Dspec Event Set Dspec Event Set FCVT.fx Fp Event Set Fp Event Set SIR L1dcache Event Set L1icache Event Set NON RSE Misses per KinstL1icache Event Set 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 CPU BRLBril BWL Threadswitch Event SetBRC BIL Tlb Event Set Tlb Event Set Event Set Descriptions for CPU Metrics 253 Glossary Glossary Set p 255 Hot spot Nop 257 Measurements p Index Symbols CPU event names shortening, 93 CPU events Daemon processes measuring259 Environment variables HP Caliper, 103 Error messages 261 Sampled measurements performing Useparensforstatementdata constant