HP Caliper User Guide | HP UX Caliper Software instruction

HP Caliper User Guide

Release 5.3 February 2011

HP Part Number: 5900-1558

Published: February 2011

Edition: 5.3

Image 1

HP UX Caliper Software manual HP Caliper User Guide

Contents

HP Caliper User Guide Copyright 2011 Hewlett-Packard Development Company, L.P Contents HP Caliper Options HP Caliper Measurement Configuration FilesRemote 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 Limitations to Using cstack 149 Pstack like functionality HP Caliper Diagnostic and Warning Messages 164Descriptions 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 HP Caliper at a Glance What Is HP Caliper?HP Caliper at a Glance HP Caliper Components User Interfaces What Is HP Caliper? Supported Hardware and Operating Systems What Does HP Caliper Run On?Supported 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 Hints on How to Make Measurements Tips for Using ViewsMaking Measurements Exploring Performance Data Getting Performance Tuning AdviceExploring 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 Available Measurements in Each Measurement Type Overview MeasurementGlobal Sampled Simultaneous fprof Sampling on Multiple PMU Counters Location of Measurement Configuration FilesSimultaneous fprof Sampling on Multiple PMU Counters You are free to rename measurement configuration files Specifying Option Values in 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 --report-details Or --processFor 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 Duration Etb-freeze-delayExample 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 Traps-reported ThreadsUser-regions See -v or --version p VersionVersion 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 is Command Line to Invoke the AdvisorWhere adviseoptions are Advice-cutoff Advice-classesAdvice-details Max-count Simplest Example Getting Started with the Advisor ExamplesMore Typical Examples Followed by Explanation of Report OutputThen, 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 Example of a .caliperinit File Configuring HP CaliperCaliperinit 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 Some opt1,... pattern Glob1 glob2 Using -p someSomeopt1,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 For example, assume that you perform this HP Caliper run Module-Centric ReportsThis produces a report similar to this truncated report Process Summary for a --group-by none Run Process SummaryProcess Summary for a Diff Run Function Details Disassembly ListingFunction 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 System Memory Configuration Table How to Read the ReportsExample 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 How Alat Metrics Are Obtained Branch Measurement Report DescriptionInformation 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 Call Graph Profile Metrics HP Caliper Call Graph Profile Results AccuracyProfiled 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 Dcache Measurement Report Description From that bundle are split issuedHow cycles Metrics Are Obtained L1DREADS Dcache Metrics Summed for Entire RunL1DREADMISSES.ALL L2DINSERTMISSES DatareferencesL2DMISSES 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 Function Source statement Instruction How Data TLB Metrics Are ObtainedInformation 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 That are misses Icache Measurement Report MetricsInformation 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 BELOSTBWDUETOFE.IMISS Itlb Measurement Report MetricsItlb 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 Call Graph Profile Scgprof Measurement Report Metrics Flat 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 Cycles lost due to RSE stalls Traps Measurement MetricsInformation 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 CPI Pred-OffMips Available only on Itanium 2 and dual-core Itanium 2 systems Cpubus Event SetCpubus 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 NON RSE Misses per Kinst L1icache Event SetL1icache 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 BRL CPUBril 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 Daemon processes measuring CPU event names shortening, 93 CPU events259 Environment variables HP Caliper, 103 Error messages 261 Sampled measurements performing Useparensforstatementdata constant