HP UX Caliper Software manual

Example Command Line for CSV Report	201
fprof Metrics Summed for Entire Run	201
Metrics for Integrity Servers Itanium 2 Systems	201
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	201
fprof Measurement Metrics	202
How fprof Metrics Are Obtained	203
icache Measurement Report Description	204
Example Command Line for Text Report	204
Example Command Line for CSV Report	204
icache Metrics Summed for Entire Run	204
Metrics for Integrity Servers Itanium 2 Systems	204
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	205
icache Measurement Report Metrics	206
Function Details	207
How Instruction Cache Metrics Are Obtained	207
itlb Measurement Report Description	208
Example Command Line for Text Report	208
Example Command Line for CSV Report	208
itlb Metrics Summed for Entire Run	208
Metrics for Integrity Servers Itanium 2 Systems	208
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	208
itlb Measurement Report Metrics	209
Function Details	210
How Instruction TLB Metrics Are Obtained	211
pmu_trace Measurement Report Description	211
Example Command Line for Text Report	211
Example Command Line for CSV Report	211
scgprof Measurement Report Description	211
Example Command Line for Text Report	211
Example Command Line for CSV Report	211
scgprof Measurement Report Metrics (Flat Profile)	212
scgprof Measurement Report Metrics (Call Graph Profile)	212
traps Measurement Report Description	214
Example Command Line for Text Report	215
Example Command Line for CSV Report	215
traps Metrics Summed for Entire Run	216
traps Measurement Metrics	217
How traps Metrics Are Obtained	218
C Event Set Descriptions for CPU Metrics (HP-UX only)	219
brpath Event Set	219
Metrics Available from this Measurement	219
brpred Event Set	220
Metrics Available from this Measurement	220
c2c Event Set	222
Metrics Available from this Measurement	222
cpi Event Set	223
Metrics Available from this Measurement	224
cpubus Event Set	225
Metrics Available from this Measurement	225
cspec Event Set	226

10 Contents

Image 10

HP UX Caliper Software manual Event Set Descriptions for CPU Metrics HP-UX only 219

Contents

HP Caliper User Guide Copyright 2011 Hewlett-Packard Development Company, L.P Contents HP Caliper Options HP Caliper Measurement Configuration FilesRemote GUI Contents Configuring HP Caliper Using the HP Caliper AdvisorUsing the HP Caliper Advisor in the GUI Threads Traps-reported User-regionsHP-UX only Version Producing a Sampled Call Stack Profile Analysis 132 Controlling the Content of Reports 104Producing a Sampled Call Graph Profile Analysis 120 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 Computer output CommandTypographic Conventions 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 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 Sampled Measurements Types of MeasurementsGlobal Measurement Precise Measurements Caliper measurement caliperoptions program programarguments What to Look for in Using HP CaliperSyntax for caliper Command Measurement Stopping HP Caliper Basic Tasks a Quick ReferenceStarting HP Caliper Showing HP Caliper Options Creating a Text Report for Analysis Using the HP Caliper AdvisorRestrictions on Using HP Caliper Creating a Report Based on Your Collected Data Caliper info Additional HP Caliper CommandsGetting Information About HP Caliper Caliper report merge diff Getting Started with the HP Caliper GUI What Is the HP Caliper GUI?What Is 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 Hints on How to Make Measurements Tips for Using ViewsMaking Measurements Exploring Performance Data Getting Performance Tuning AdviceExploring Performance Data Native Local GUI Getting HelpStarting the GUI Remote GUI Login Screen Starting the GUI HP Caliper Measurement Configuration Files Measurement Configuration Files Provided with HP Caliper Fprof DtlbEcount 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 Multiple Ways to Specify HP Caliper Option Values HP Caliper OptionsBasic Information About Options Examples Hierarchy for Processing an Option Value Or --databaseOr --duration Examples Or --help Or --options-fileOr -? Or --metrics Or --output-file Cpuevent Or --report-details Or --processFor PMU Histogram Reports Speriod Srate ,variation ,cpuevent Or --sampling-specFor Function Coverage Reports Rate CPUCYCLES,10000,10% Default value is 5 percentOr --version Branchevent Advice-details Advice-classesAdvice-cutoff Analysis-focus Bus-speed int Bus-speedCallpath-cutoff Callpath-cutoffpercentcutoff,cumpercentcutoff,mincount Cpu-counter Context-linesCpu-aggregation Cpu-details Database Csv-fileDcache-data-profile Dbrp Details Db-saveDescription-details Detail-cutoff Duration Etb-freeze-delayExample Etb-walkback-cycles Event-defaultsEvent-defaults privilege-level-mask=levelthreshold=int Etb-walkback-cycles integer Fold Exclude-caliperExclude-idle Frame-depth Ibrp HelpHotpaths Info Kernel-path JoinJre Kernel-stack Memory-usage= Latency-bucketsMeasure-on-interrupts Metrics Module-include Module-defaultModule-exclude Module-search-path Options-file NoinlinesOmr Output-file Percent-sample Per-module-dataPercent-columns Prim-cutoff See -p or --process p ProcessProcess-cutoff Process-cutoffpercentcutoff,cumpercentcutoff,mincount Report-details Read-init-fileReport Rule-files Using --scope system for System-Wide Measurements Psetid psetid Sort-by SearchSkip-functions Sort-bymetric,cpuevent Summary-cutoff Source-path-mapStop-functions Summary-cutoffpercentcutoff,cumpercentcutoff,mincount Term-display System-model Linux onlySystem-usage= System-modelmodel-number,number-of-cells Traps-reported ThreadsUser-regions See -v or --version p VersionVersion Example of an HP Caliper Advisor Report Using the HP Caliper AdvisorWhat Is the HP Caliper Advisor? 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-details Advice-classesAdvice-cutoff 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 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 Example of a .caliperinit File Configuring HP CaliperCaliperinit file, you can then simply type Suppressinitwarnings = TrueFalse Setting Constants in the .caliperinit FileDisasmtargetnamelimit = limit Suppressstatementdata = TrueFalse Specifying Which CPU Events to Measure Configuring Data CollectionConfiguring Data Collection Shortening CPU Event Names Module-include modulelist Module-default Module-include Module-excludeSpecifying Which Load Modules to Collect Data For Module-exclude modulelist Default Settings for Load Module Data Collection How to Specify Load Module Names Process Tree Report Controlling Granularity of Data Collection and ReportsSpecifying Processes to Measure For more information, see -s or --sampling-spec p Root-forks DefaultSyntax for -p Option Customfunctionname Some opt1,... pattern Glob1 glob2 Using -p someSomeopt1,opt2,...pattern To measure only ecom and ld Examples of the -p OptionProcess Origin Options Used with -p some Reports information for cc root, cc fork, cc fork, ctcom Using HP Caliper to Generate Test Suite Reports Using HP Caliper in Your Build ProcessUsing HP Caliper in Testing and Quality Assurance 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 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 Address Types Shown Branch Targets in Disassembly ListingsSource Position Correlation Source Line Data Unnamed Functions How Functions Are Named in ReportsVSE Information Shown in Report Output Unknown Functions Controlling the Content of Reports Names and Locations for the Databases Changing the Default Name and LocationHow HP Caliper Saves Data in Databases Or simply Creating Reports from Multiple Databases You can use the caliper report merge diff command toWhere reportoptions is one or more of these options Caliper report merge diff reportoptions databases Caliper report reportoptions database Databases is one of theseDatabase2 database1 for caliper diff 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 As cc1 ld Example of How to Use the caliper diff CommandCstack Pmutrace Scgprof As cc1 Differences Between scgprof and cgprof Producing a Sampled Call Graph Profile AnalysisHow Sampled Call Graph Profile Analysis Works Producing a Sampled Call Graph Profile Analysis Caliper scgprof caliperoptions program programarguments Running the HP Caliper Sampled Call Graph ProfileSampled Call Graph Text Report Example 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 Call Graph Part of the Report Sampled Call Graph Profile Report DetailsFlat Profile Part of the Report Hot Call Paths Part of the Report Gprof Fallacy and Possibly Misleading Results Diagnostic MessagesDiagnostic Messages appear at the end of the report Gprof Fallacy and Possibly Misleading Results Call Stack Profile Text Report Example for HP-UX Producing a Sampled Call Stack Profile AnalysisRunning HP Caliper to Produce a Call Stack Profile 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 Samples-running HP-UX only Samples-blocked HP-UX only Call Stack Profile Report DetailsBlocking Primitives Summary Part of the Report Call Stack Profile Report Details Example 4 Sample cstack Report Blocking Primitives Details Pstack like functionality Limitations to Using cstackAvoids gprof Fallacy 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 System Memory Configuration Table How to Read the ReportsExample Report Output 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 Run ./myprog and find the process ID of the process Taking PMU Samples in Your CodeTriggering PMU Samples in Specific Code Regions 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 HP Caliper Diagnostic and Warning MessagesError #28 Caliper Invalid Measurement Combination Instructions Labeled Stub Mispredicted Branches Example Mispredicted Branches PMU Sample Hits Outside Function Range Scgprof Reports Require Kernel Patch Scgprof Reports Require Kernel Patch Descriptions of Measurement Reports Example Command Line for Text ReportExample Command Line for CSV Report Alat Measurement Report Description Alat Metrics Summed for Entire Run Metrics for Integrity Servers Itanium 2 Systems INSTCHKALDCALAT.INT Alat Measurement Report MetricsINSTCHKALDCALAT.FP INSTFAILEDCHKALDCALAT.FP How Alat Metrics Are Obtained Branch Measurement Report DescriptionInformation in alat Measurement Reports Branch Metrics Summed for Entire Run BRMISPREDDETAIL.RETURN.CORRECTPRED BRMISPREDDETAIL.NRETIND.WRONGPATHBRMISPREDDETAIL.NRETIND.WRONGTARGET BRMISPREDDETAIL.RETURN.WRONGPATH Branch Measurement Report Metrics Information in branch Measurement Reports Available only on HP-UX Cgprof Report DescriptionHow branch Metrics Are Obtained 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 Column Description Func Hits In Children Cpu Measurement Report DescriptionInformation in cgprof Measurement Report Children Listings This child entry Example Command Lines for Text Report CPU Event Sets L1icache DspecL1dcache L2cache Cstack Measurement Report Metrics ThreadswitchCstack Measurement Report Description Sysbus Message queue, socket, pipe, file descriptor Be resolved to a symbolColumn Description Total Hits Waiting Semaphore, message queue, socket, pipe, file descriptor Children Cycles Measurement Report DescriptionParent Func Hits Cycles Measurement Report Description Cycles Metrics Summed for Entire Run Cycles Measurement Metrics Information in cycles Measurement Reports Dcache Measurement Report Description From that bundle are split issuedHow cycles Metrics Are Obtained L1DREADS Dcache Metrics Summed for Entire RunL1DREADMISSES.ALL L2DINSERTMISSES DatareferencesL2DMISSES Information in dcache Measurement Reports Dcache Measurement Report MetricsL2DREFERENCES.ALL Cycles Object Avg. Dcache Example dcache Reports Dcache Measurement Report Description How Data Cache Metrics Are Obtained How the Data Summary Information Is Obtained Dtlb Measurement Report DescriptionHow Latency Bucket Metrics Are Obtained Dtlb Measurement Report Description Dtlbinsertshpw Dtlb Metrics Summed for Entire RunL2DTLBMISSES L2DTLBMISSES / Datareferences Dtlb Measurement Report Metrics Cycles lost due to all stalls lower is better Function Source statement Instruction How Data TLB Metrics Are ObtainedInformation in dtlb Measurement Reports Cpucycles Ecount Measurement Report DescriptionEcount Metrics Summed for Entire Run Ecount Measurement Report Description Descriptions of Measurement Reports Fcount Measurement Report Metrics Fcount Measurement Report DescriptionFcover Measurement Report Description Fcover Measurement Report Metrics Directory Fprof Measurement Report DescriptionUnknown Source Files Function Full pipe bubbles in main pipe Fprof Metrics Summed for Entire RunNumber of elapsed processor cycles Fprof Measurement Report Description Fprof Measurement Metrics How fprof Metrics Are Obtained Information in fprof Measurement Reports L1IREADS Icache Measurement Report DescriptionIcache Metrics Summed for Entire Run L2INSTDEMANDREADS L1IPREFETCHES That are misses Icache Measurement Report MetricsInformation in icache Measurement Reports Function Details How Instruction Cache Metrics Are Obtained ITLBMISSESFETCH.L1ITLB Itlb Measurement Report DescriptionItlb Metrics Summed for Entire Run ITLBMISSESFETCH.L2ITLB BELOSTBWDUETOFE.IMISS Itlb Measurement Report MetricsItlb Measurement Report Description Function Statement Cache line Information in itlb Measurement Reports How Instruction TLB Metrics Are Obtained Pmutrace Measurement Report DescriptionScgprof Measurement Report Description Pmutrace Measurement Report Description Scgprof Measurement Report Metrics Call Graph Profile Scgprof Measurement Report Metrics Flat ProfileIs profiled otherwise blank Information in scgprof Measurement Report Parent Listings Scgprof Measurement Report Description Traps Measurement Report Description Dbit VfaultDarght 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 Metrics Available from this Measurement Event Set Descriptions for CPU MetricsBrpath Event Set 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 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 Fp Event Set FCVT.fx SIR Fp Event Set 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 BRC Threadswitch Event SetBWL 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 Daemon processes measuring CPU event names shortening, 93 CPU events259 Environment variables HP Caliper, 103 Error messages Sampled measurements performing 261 Useparensforstatementdata constant