HP UX IPFilter Software specs

Table 8 Available Metrics for Report Sorting and Cutoffs

Report Name	Notes	Available Metrics
alat		•	sampled-misses (default)
branch		•	target
		•	branch-ways
		•	mispredict (default)
		• back-end-only-mispredict
cgprof (HP-UX only)		•	call-count
		• msecs-per-call
		•	samples (default)
		•	seconds
cstack		•	samples (default)
		• samples-running (HP-UX only)
		• sampled-blocked (HP-UX only)

dcache

dtlb

fprof

fcount (HP-UX only) Sorting only

fcover (HP-UX only)

icache

itlb

scgprof

•avg-latency

•latency (default)

•sampled-misses

•hpw-fills

•l2-fills

•sampled-misses (default)

•soft-fills

•samples (Default)

•samples,cpu_event (for simultaneous fprof sampling)

•call-count (Default)

•address

•name

•reached_count

•reached_percent

•unreached_count

•unreached_percent (default)

•avg-latency

•latency (default)

•sampled-misses

•hpw-fills

•sampled-misses (default)

•soft-fills

•call-count

•msecs-per-call

•samples (default)

•seconds

108 Controlling the Content of Reports

Image 108

HP UX IPFilter Software manual Available Metrics for Report Sorting and Cutoffs

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 What is HP Caliper? What is HP Caliper?HP Caliper at a Glance 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 Location of Measurement Configuration Files Specifying Option Values in Measurement Configuration FilesSimultaneous fprof Sampling on Multiple PMU Counters 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 Etb-freeze-delay DurationExample Event-defaults Event-defaults privilege-level-mask=levelthreshold=intEtb-walkback-cycles Etb-walkback-cycles integer Exclude-caliper Exclude-idleFold Frame-depth Help HotpathsIbrp 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 Term-display ThreadsTraps-reported 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 Steps in Using the Advisor Using the HP Caliper AdvisorExample 1 HP Caliper Advisor Report Command Line to Invoke the Advisor Command line isWhere adviseoptions are Command Line to Invoke the Advisor Advice-classes Advice-cutoffAdvice-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 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 Configuring Data Collection Specifying Which CPU Events to MeasureShortening CPU Event Names 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 Using -p some Glob1glob2Someopt1,opt2,...pattern 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 Using HP Caliper to Generate Test Suite Reports Attaching to a Running Process to Perform MeasurementsCaliper measurement options pid pid Options for the caliper info Command Or --cpu-counterCcounternamekeywordall Examples of the caliper info Command Or --detailsOr --output-file Or --report HP Caliper Environment Variables Controlling the Content of Reports Layout of an HP Caliper Text or CSV ReportLayout 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 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 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 Caliper report reportoptions database Caliper merge reportoptions database1 database2Creating Reports from Multiple Databases 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 How to Read the Reports System Memory Configuration TableExample 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 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 Scgprof Reports Require Kernel PatchPMU Sample Hits Outside Function Range 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 BERSEBUBBLE.ALL CPUCPLCHANGES.ALL CPUOPCYCLES.ALL RetiredinstnopCYCBEBUBBLE.ANY 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 Bubbles, or partial replays RAW or WAW dependency condition of the instructionTo RAW hazard in an instructions GR load 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 Ecount Measurement Report Description Ecount Metrics Summed for Entire RunCpucycles 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 Pmutrace Measurement Report Description Scgprof Measurement Report DescriptionScgprof Measurement Report Metrics Flat Profile Scgprof Measurement Report Metrics Call Graph Profile Is profiled otherwise blankScgprof Measurement Report Description 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 Metrics Available for Intel Itanium 9500 series systemsMemreq Event Set 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 Symbols Index273 CPU event names shortening, 94 CPU events Daemon processes measuring Environment variables HP Caliper, 104 Error messages 275 Sampled measurements performing Useparensforstatementdata constant 277