Descriptions of Measurement Reports 171 | HP UX IPFilter Software

Example Report Output	156
How to Read the Reports	156
System Memory Configuration Table	156
Process Memory Usage Table	157
Measuring System Usage Concurrently with Other Measurements (HP-UX only)	158
Example Report Output	158
Interpreting the Data	160
Attaching to a Running Process to Perform Precise Measurements (HP-UX only)	160
Taking PMU Samples in Your Code (HP-UX only)	161
Triggering PMU Samples in Specific Code Regions	161
Precautions When Using Triggered Samples	162
Restricting PMU Measurements to Specific Code Regions	163
14 Documentation feedback	166
A HP Caliper Diagnostic and Warning Messages	167
ERROR #28: Caliper Invalid Measurement Combination	167
Instructions Labeled STUB	167
Mispredicted Branches	167
PMU Sample Hits Outside Function Range	169
scgprof Reports Require Kernel Patch (HP-UX only)	169
B Descriptions of Measurement Reports	171
alat Measurement Report Description	171
Example Command Line for Text Report	171
Example Command Line for CSV Report	171
alat Metrics Summed for Entire Run	171
Metrics for Integrity Servers Itanium 2 Systems	172
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	172
Metrics for Integrity Servers Intel® Itanium® 9500 Processors Systems	173
alat Measurement Report Metrics	174
How ALAT Metrics Are Obtained	175
branch Measurement Report Description	175
Example Command Line for Text Report	175
Example Command Line for CSV Report	175
branch Metrics Summed for Entire Run	175
Metrics for Integrity Servers Itanium 2 Systems	175
Metrics for Integrity Servers Dual-Core Itanium 2 and Itanium 9300 Quad-Core Processor
Systems	176
Metrics for Integrity Servers Intel® Itanium® 9500 Processors Systems	177
branch Measurement Report Metrics	179
How branch Metrics Are Obtained	180
cgprof Report Description (HP-UX only)	180
Example Command Line for Text Report	180
Example Command Line for CSV Report	180
HP Caliper Call Graph Profile Results Accuracy	180
Call Graph Profile Metrics	181
cpu Measurement Report Description (HP-UX only)	183
Example Command Lines for Text Report	184
Example Command Line for CSV Report	184
CPU Event Sets	184
cstack Measurement Report Description	186
Example Command Line for Text Report	186
Example Command Line for CSV Report	186
cstack Measurement Report Metrics	186

8Contents

Image 8

HP UX IPFilter Software manual Descriptions of Measurement Reports 171

Contents

HP Caliper User Guide Copyright 2014 Hewlett-Packard Development Company, L.P Contents HP Caliper Measurement Configuration Files HP Caliper Options Contents Using the HP Caliper Advisor Using the HP Caliper Advisor in the GUIConfiguring HP Caliper Controlling the Content of Reports 105 Producing a Sampled Call Graph Profile Analysis 122 Producing a Sampled Call Stack Profile Analysis 134 Descriptions of Measurement Reports 171 Contents Event Set Descriptions for CPU Metrics HP-UX only 232 Metrics for Integrity Servers Itanium 2 Systems 211Systems 211 212 Glossary 268 Index 273 HP secure development lifecycle About This Document Command Typographic ConventionsComputer output File name Related Documents HP Encourages Your Questions HP Caliper at a Glance What is HP Caliper?What is HP Caliper? HP Caliper Components User Interfaces HP Caliper at a Glance What Does HP Caliper Run On? Supported Hardware and Operating SystemsSupported Compilers and Application Environments What Does HP Caliper Run On? Summary of HP Caliper Features Getting Started with the HP Caliper Command-Line Interface Getting Started with the HP Caliper Command-Line Interface Cpucycles Target Getting Started with the HP Caliper Command-Line Interface Example Adding Instructions to an fprof Report Example Adding Instructions to an fprof Report Getting Started with the HP Caliper Command-Line Interface 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? Getting Started with the HP Caliper GUIWindow Basics Getting Started with the HP Caliper GUI Projects View Window Basics Collect View Projects View Analyze View Collect View Advisor View Analyze View Console View Advisor View Diagnostics View Help View Tips for Using Views Hints on How to Make MeasurementsMaking Measurements Making Measurements Getting Performance Tuning Advice Exploring Performance Data Getting Help Starting the GUINative Local GUI Remote GUI Login Screen HP Caliper Measurement Configuration Files Measurement Configuration Files Provided with HP Caliper Dtlb EcountFprof Icache Overview Measurement Overview Measurement Simultaneous fprof Sampling on Multiple PMU Counters Location of Measurement Configuration FilesSpecifying Option Values in Measurement Configuration Files Location of Measurement Configuration Files See Hierarchy for Processing an Option Value p 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 Or --process Or --report-detailsFor PMU Histogram Reports For Function Coverage Reports Or --sampling-spec Speriod Srate ,variation ,cpueventRate Variation Advice-classes Or --versionCPUCYCLES,10000,10% Branchevent Advice-cutoff Advice-detailsAnalysis-focus Branch-sampling-spec Bus-speed Callpath-cutoffBus-speed int Callpath-cutoffpercentcutoff,cumpercentcutoff,mincount Context-lines Cpu-aggregationCpu-counter Cpu-details Dcache-data-profile DatabaseDcache-hits Dcache-stores Db-save Debug-file-path=Description-details Details 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 Ibrp HelpHotpaths Info InlinesJoin Jre Kernel-stack Latency-bucketsMeasure-on-interrupts Memory-usage= Module-default MetricsModule-exclude Module-include Module-search-path NoinlinesOmr Module-search-path directorydirectory Options-file Output-fileOverflow-block Per-module-data 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 Sw-process-list= System-model Linux onlySystem-usage= System-modelmodel-number,number-of-cells Traps-reported Term-displayThreads User-regions defaultrum-sum User-regionsVersion Rum and sum 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 AdvisorUsing the HP Caliper Advisor Command Line to Invoke the Advisor Command line isWhere adviseoptions are Command Line to Invoke the Advisor 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 How to Read an Advisor Report Suggestions for Using the HP Caliper Advisor How the HP Caliper Advisor Works How the HP Caliper Advisor Works Using the HP Caliper Advisor in the GUI Basic Steps in Using the HP Caliper Advisor in the GUIUsing the HP Caliper Advisor in the GUI Making Performance Measurement Runs Selecting Performance Data to Analyze Optional Selecting Performance Data to Analyze Optional Projects View, with a Single Project Selected Generating Advice Generating Advice Reviewing and Acting on the Advice HP Caliper GUI Advisor Menu Reviewing and Acting on the Advice Advisor Report in the HP Caliper GUI Configuring HP Caliper Configuring HP CaliperExample of a .caliperinit File Caliperinit file, you can then simply type Setting Constants in the .caliperinit File Disasmtargetnamelimit = limitSuppressinitwarnings = TrueFalse Suppressstatementdata = TrueFalse Shortening CPU Event Names Configuring Data CollectionSpecifying Which CPU Events to Measure Default Settings for Load Module Data Collection Module-default Module-include Module-excludeSpecifying Which Load Modules to Collect Data For Module-include modulelist 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 someGlob1glob2 Using HP Caliper in Your Build Process Using HP Caliper in Testing and Quality AssuranceExamples of the -p Option Process Origin Options Used with -p some Caliper measurement options pid pid Using HP Caliper to Generate Test Suite ReportsAttaching to a Running Process to Perform Measurements Ccounternamekeywordall Options for the caliper info CommandOr --cpu-counter Examples of the caliper info Command Or --detailsOr --output-file Or --report HP Caliper Environment Variables Layout of an HP Caliper Text or CSV Report Controlling the Content of ReportsLayout of an HP Caliper Text or CSV Report Controlling 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 Creating Reports from Multiple DatabasesCaliper report merge diff reportoptions databases Database2 database1 for caliper diff Creating Reports from Multiple Databases Caliper report reportoptions databaseCaliper 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 153 HP Caliper Features Specific to HP-UX Measuring Memory Usage Concurrently with Other Measurements Examples of the --memory-usage= Option Some examples of the option followMemory-usage=all Memory-usage=beginend 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 162 shows part of the resulting report Restricting PMU Measurements to Specific Code Regions Caliperpmuenable Restricting PMU Measurement to Specific Code Documentation feedback Documentation feedback HP Caliper Diagnostic and Warning Messages Error #28 Caliper Invalid Measurement CombinationError #28 Caliper Invalid Measurement Combination Instructions Labeled Stub HP Caliper Diagnostic and Warning Messages Mispredicted Branches Example PMU Sample Hits Outside Function Range PMU Sample Hits Outside Function RangeScgprof Reports Require Kernel Patch HP Caliper Diagnostic and Warning Messages Example Command Line for Text Report Example Command Line for CSV ReportDescriptions of Measurement Reports Alat Measurement Report Description Metrics for Integrity Servers Itanium 2 Systems INSTCHKALDCALAT.INT INSTFAILEDCHKALDCALAT.FP Alat Measurement Report Metrics AlatentryreplacedAlatstorehit See Branch Measurement Report Description How Alat Metrics Are ObtainedBranch Metrics Summed for Entire Run BRMISPREDDETAIL.ALL.CORRECTPRED BRMISPREDDETAIL.ALL.WRONGTARGET BEFLUSHBUBBLE.ALLBRMISPREDDETAIL.IPREL.CORRECTPRED BRMISPREDDETAIL.IPREL.WRONGPATH BRPREDDETAIL.IPRELCORRPRED BRPREDDETAIL.IPRELWRONGPATHNumber of IP-relative branch types with mispredicted path BRPREDDETAIL.IPRELWRONGTARGET BRPREDDETAIL.NONRETINDCORRPRED BRPREDDETAIL.RETURNWRONGPATHBRPREDDETAIL.NONRETINDWRONGTARGET BRPREDDETAIL.RETURNCORRPRED Branch Measurement Report Metrics Information in branch Measurement Reports Cgprof Report Description How branch Metrics Are ObtainedHP Caliper Call Graph Profile Results Accuracy Available only on HP-UX Call Graph Profile Metrics Information in cgprof Measurement Report Fields Flat Profile Information in cgprof Measurement Report Parent Listings Cpu Measurement Report Description Information in cgprof Measurement Report Children Listings Example Command Lines for Text Report CPU Event Sets L2dcache,l2icache L2dcacheL2icache L3cache Cstack Measurement Report Description Cstack Measurement Report Metrics Be resolved to a symbol Column Description HP-UX onlyHP-UX only Sample Hits Waiting Sample Hits Blocked Cycles Measurement Report Description Column Run + Block Hits HP-UX onlyParent Func Hits Children Cycles Metrics Summed for Entire Run CYCBEBUBBLE.ANY BERSEBUBBLE.ALL CPUCPLCHANGES.ALL CPUOPCYCLES.ALLRetiredinstnop CYCBEWB2FLUSH.ANY CYCBEIBDSTALL.ANY CYCBEIBDSTALL.GRLOAD CYCBEDETREPLAY.GRLOAD From that bundle are split issued Cycles Measurement MetricsHow cycles Metrics Are Obtained Information in cycles Measurement Reports Dcache Measurement Report Description Dcache Measurement Report Description Dcache Metrics Summed for Entire Run L1DREADSL1DREADMISSES.ALL Datareferences To RAW hazard in an instructions GR load Bubbles, or partial replaysRAW or WAW dependency condition of the instruction Dcache Measurement Report Metrics Source statement Instruction Information in dcache Measurement Reports 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 IA64INSTRETIRED L1DTLBTRANSFER L1DREADS L2DTLBMISSES FLDTLBLOADMISS.ANYFLDTLBINSREQ.NONRETIRED FLDTLBINSREQ.RETIRED Dtlb Measurement Report Metrics DTLBHPWREQBLKMISS.FAILL2 Dtlb HPW How Data TLB Metrics Are Obtained Information in dtlb Measurement Reports Cpucycles Ecount Measurement Report DescriptionEcount Metrics Summed for Entire Run Ecount Measurement Report Description Fcount Measurement Report Description Only on HP-UX Fcover Measurement Report Description Fcount Measurement Report MetricsFcover Measurement Report Metrics Information in fcount Measurement Reports Fprof Measurement Report Description Unknown Source FilesDirectory Function Fprof Metrics Summed for Entire Run BERSEBUBBLE.ALL CYCBEWB2FLUSH.ANY Number of CPU cycles spent in WB2 Write backFlushing of instructions Dispersal without issuing instructions Fprof Measurement Metrics How fprof Metrics Are Obtained Information in fprof Measurement Reports Icache Measurement Report Description Icache Metrics Summed for Entire RunL1IREADS L2INSTDEMANDREADS L2IDEMANDREADS L2IPREFETCHESL2IREADS.ALL.ALL L2IREADS.MISS.ALL L1 instruction cache misses per Icache Measurement Report Metrics Information in icache Measurement Reports Itlb Measurement Report Description Function DetailsHow Instruction Cache Metrics Are Obtained Itlb Measurement Report Description Itlb Metrics Summed for Entire Run ITLBMISSESFETCH.L1ITLBITLBMISSESFETCH.L2ITLB BELOSTBWDUETOFE.ALL L1ITLBINSERTSHPW L1IREADS FlitlbmissMlitlbmiss Mlitlbhpwaborts Itlb Measurement Report Metrics FlitlbinserthpwCycles lost due to branch execution Information in itlb Measurement Reports How Instruction TLB Metrics Are Obtained Column Description Itlb L2 FillItlb HPW Fill Itlb Soft Fill Scgprof Measurement Report Metrics Flat Profile Pmutrace Measurement Report DescriptionScgprof Measurement Report Description Scgprof Measurement Report Description Scgprof Measurement Report Metrics Call Graph ProfileIs profiled otherwise blank Information in scgprof Measurement Report Parent Listings Information in scgprof Measurement Report Children ListingsColumn Description Call Total Column Description Traps Measurement Report Description Traps Metrics Summed for Entire Run Cycles lost due to pipeline-flush stalls Cycles lost due to RSE stalls Traps Measurement Metrics Information in traps Measurement Reports 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 Brpred Event Set Iprel C2c Event Set C2c Event Set Cpi Event Set Pred-Off CPIMips Cpi Event Set Cpubus Event Set Available only on Itanium 2 and dual-core Itanium 2 systems Cspec Event Set Cspec Event Set Dispersal Event Set Dspec Event Set Dspec Event Set Metrics Available from this Measurement Fp Event Set FCVT.fx SIR L1dcache Event Set L1dcache Event Set L1icache Event Set NON RSE Misses per Kinst L1icache Event Set L2cache Event Set L2cache Event Set L2dcache Event Set L2icache Event Set L2icache Event Set Metrics Available from this Measurement L3cache Event Set L3cache Event Set Event Set Descriptions for CPU Metrics Memreq Event Set Memreq Event SetMetrics Available for Intel Itanium 9500 series systems Queues Event Set Queues Event Set Snoop Event Set Replay Event Set Stall Event Set Include idle --exclude-idle False Sysbus Event Set Metrics Available for Intel Itanium 9500 series systemsDcache Sysbus Event Set CPU Threadswitch Event Set Hint Stall MLD use or HPW miss or IBQ being empty Tlb Event Set Tlb Event Set Glossary Glossary Set p 269 EAR Measurement Configuration Files p 271 TLB 273 SymbolsIndex CPU event names shortening, 94 CPU events Daemon processes measuring Environment variables HP Caliper, 104 Error messages 275 Sampled measurements performing Useparensforstatementdata constant 277