Documentation feedback | HP UX IPFilter Software instruction

14 Documentation feedback

HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.

166 Documentation feedback

Image 166

HP UX IPFilter Software manual Documentation feedback

Contents

HP Caliper User Guide Copyright 2014 Hewlett-Packard Development Company, L.P Contents HP Caliper Measurement Configuration Files HP Caliper Options Contents Configuring HP Caliper Using the HP Caliper AdvisorUsing the HP Caliper Advisor in the GUI 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 Systems 211 Event Set Descriptions for CPU Metrics HP-UX only 232Metrics for Integrity Servers Itanium 2 Systems 211 212 Glossary 268 Index 273 HP secure development lifecycle About This Document Computer output CommandTypographic Conventions 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 Supported Compilers and Application Environments What Does HP Caliper Run On?Supported Hardware and Operating Systems 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 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 Window Basics What Is the HP Caliper GUI?Getting Started with the HP Caliper GUI 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 Making Measurements Tips for Using ViewsHints on How to Make Measurements Making Measurements Getting Performance Tuning Advice Exploring Performance Data Native Local GUI Getting HelpStarting the GUI Remote GUI Login Screen HP Caliper Measurement Configuration Files Measurement Configuration Files Provided with HP Caliper Fprof DtlbEcount Icache Overview Measurement Overview Measurement Specifying Option Values in Measurement Configuration Files Location of Measurement Configuration FilesSimultaneous fprof Sampling on Multiple PMU Counters Location of Measurement Configuration Files See 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 For PMU Histogram Reports Or --processOr --report-details For Function Coverage Reports Rate Or --sampling-specSperiod Srate ,variation ,cpuevent Variation CPUCYCLES,10000,10% Advice-classesOr --version Branchevent Analysis-focus Advice-cutoffAdvice-details Branch-sampling-spec Bus-speed int Bus-speedCallpath-cutoff Callpath-cutoffpercentcutoff,cumpercentcutoff,mincount Cpu-counter Context-linesCpu-aggregation Cpu-details Dcache-hits Dcache-data-profileDatabase Dcache-stores Description-details Db-saveDebug-file-path= Details 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 Hotpaths HelpIbrp Join InfoInlines Jre Measure-on-interrupts Kernel-stackLatency-buckets Memory-usage= Module-exclude Module-defaultMetrics Module-include Omr Module-search-pathNoinlines Module-search-path directorydirectory Overflow-block Options-fileOutput-file Per-module-data 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 System-usage= Sw-process-list=System-model Linux only System-modelmodel-number,number-of-cells Threads Term-displayTraps-reported Version User-regions defaultrum-sumUser-regions Rum and sum Example of an HP Caliper Advisor Report Using the HP Caliper AdvisorWhat Is the HP Caliper Advisor? Limitations to Keep in Mind Using the HP Caliper Advisor Steps in Using the AdvisorExample 1 HP Caliper Advisor Report Where adviseoptions are Command Line to Invoke the AdvisorCommand line is Command Line to Invoke the Advisor 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 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 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 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 Example of a .caliperinit File Configuring HP CaliperConfiguring HP Caliper Caliperinit 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 CollectionShortening CPU Event Names Specifying Which Load Modules to Collect Data For Default Settings for Load Module Data CollectionModule-default Module-include Module-exclude Module-include modulelist 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 Glob1glob2 Using -p someSomeopt1,opt2,...pattern Examples of the -p Option Using HP Caliper in Your Build ProcessUsing HP Caliper in Testing and Quality Assurance Process Origin Options Used with -p some Attaching to a Running Process to Perform Measurements Using HP Caliper to Generate Test Suite ReportsCaliper measurement options pid pid Or --cpu-counter Options for the caliper info CommandCcounternamekeywordall Or --output-file Examples of the caliper info CommandOr --details 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 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 Caliper report merge diff reportoptions databases You can use the caliper report merge diff command toCreating Reports from Multiple Databases Database2 database1 for caliper diff Caliper merge reportoptions database1 database2 Caliper report reportoptions databaseCreating 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 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 153 HP Caliper Features Specific to HP-UX Measuring Memory Usage Concurrently with Other Measurements Memory-usage=all Examples of the --memory-usage= OptionSome examples of the option follow Memory-usage=beginend 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 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 Error #28 Caliper Invalid Measurement Combination HP Caliper Diagnostic and Warning MessagesError #28 Caliper Invalid Measurement Combination Instructions Labeled Stub HP Caliper Diagnostic and Warning Messages Mispredicted Branches Example Scgprof Reports Require Kernel Patch PMU Sample Hits Outside Function RangePMU Sample Hits Outside Function Range HP Caliper Diagnostic and Warning Messages Descriptions of Measurement Reports Example Command Line for Text ReportExample Command Line for CSV Report Alat Measurement Report Description Metrics for Integrity Servers Itanium 2 Systems INSTCHKALDCALAT.INT INSTFAILEDCHKALDCALAT.FP Alatstorehit Alat Measurement Report MetricsAlatentryreplaced See Branch Metrics Summed for Entire Run Branch Measurement Report DescriptionHow Alat Metrics Are Obtained BRMISPREDDETAIL.ALL.CORRECTPRED BRMISPREDDETAIL.IPREL.CORRECTPRED BRMISPREDDETAIL.ALL.WRONGTARGETBEFLUSHBUBBLE.ALL BRMISPREDDETAIL.IPREL.WRONGPATH Number of IP-relative branch types with mispredicted path BRPREDDETAIL.IPRELCORRPREDBRPREDDETAIL.IPRELWRONGPATH BRPREDDETAIL.IPRELWRONGTARGET BRPREDDETAIL.NONRETINDWRONGTARGET BRPREDDETAIL.NONRETINDCORRPREDBRPREDDETAIL.RETURNWRONGPATH BRPREDDETAIL.RETURNCORRPRED Branch Measurement Report Metrics Information in branch Measurement Reports HP Caliper Call Graph Profile Results Accuracy Cgprof Report DescriptionHow branch Metrics Are Obtained 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 L2icache L2dcache,l2icacheL2dcache L3cache Cstack Measurement Report Description Cstack Measurement Report Metrics HP-UX only Sample Hits Waiting Be resolved to a symbolColumn Description HP-UX only Sample Hits Blocked Parent Func Hits Cycles Measurement Report DescriptionColumn Run + Block Hits HP-UX only Children Cycles Metrics Summed for Entire Run Retiredinstnop BERSEBUBBLE.ALL CPUCPLCHANGES.ALL CPUOPCYCLES.ALLCYCBEBUBBLE.ANY CYCBEWB2FLUSH.ANY CYCBEIBDSTALL.ANY CYCBEIBDSTALL.GRLOAD CYCBEDETREPLAY.GRLOAD How cycles Metrics Are Obtained From that bundle are split issuedCycles Measurement Metrics Information in cycles Measurement Reports Dcache Measurement Report Description Dcache Measurement Report Description L1DREADMISSES.ALL Dcache Metrics Summed for Entire RunL1DREADS Datareferences RAW or WAW dependency condition of the instruction Bubbles, or partial replaysTo 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 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 FLDTLBINSREQ.NONRETIRED IA64INSTRETIRED L1DTLBTRANSFER L1DREADS L2DTLBMISSESFLDTLBLOADMISS.ANY FLDTLBINSREQ.RETIRED L2 Dtlb Dtlb Measurement Report MetricsDTLBHPWREQBLKMISS.FAIL HPW How Data TLB Metrics Are Obtained Information in dtlb Measurement Reports Ecount Metrics Summed for Entire Run Ecount Measurement Report DescriptionCpucycles Ecount Measurement Report Description Fcount Measurement Report Description Only on HP-UX Fcover Measurement Report Metrics Fcover Measurement Report DescriptionFcount Measurement Report Metrics Information in fcount Measurement Reports Directory Fprof Measurement Report DescriptionUnknown Source Files Function Fprof Metrics Summed for Entire Run BERSEBUBBLE.ALL Flushing of instructions CYCBEWB2FLUSH.ANYNumber of CPU cycles spent in WB2 Write back Dispersal without issuing instructions Fprof Measurement Metrics How fprof Metrics Are Obtained Information in fprof Measurement Reports L1IREADS Icache Measurement Report DescriptionIcache Metrics Summed for Entire Run L2INSTDEMANDREADS L2IREADS.ALL.ALL L2IDEMANDREADSL2IPREFETCHES L2IREADS.MISS.ALL L1 instruction cache misses per Icache Measurement Report Metrics Information in icache Measurement Reports How Instruction Cache Metrics Are Obtained Itlb Measurement Report DescriptionFunction Details Itlb Measurement Report Description ITLBMISSESFETCH.L2ITLB Itlb Metrics Summed for Entire RunITLBMISSESFETCH.L1ITLB BELOSTBWDUETOFE.ALL Mlitlbmiss L1ITLBINSERTSHPW L1IREADSFlitlbmiss Mlitlbhpwaborts Cycles lost due to branch execution Itlb Measurement Report MetricsFlitlbinserthpw Information in itlb Measurement Reports Itlb HPW Fill How Instruction TLB Metrics Are ObtainedColumn Description Itlb L2 Fill Itlb Soft Fill Scgprof Measurement Report Description Pmutrace Measurement Report DescriptionScgprof Measurement Report Metrics Flat Profile Is profiled otherwise blank Scgprof Measurement Report Metrics Call Graph ProfileScgprof Measurement Report Description Column Description Call Total Information in scgprof Measurement Report Parent ListingsInformation in scgprof Measurement Report Children Listings 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 Metrics Available from this Measurement Event Set Descriptions for CPU MetricsBrpath Event Set Include idle --exclude-idle False Brpred Event Set Brpred Event Set Iprel C2c Event Set C2c Event Set Cpi Event Set Mips Pred-OffCPI 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 Metrics Available for Intel Itanium 9500 series systems Memreq Event SetMemreq Event Set Queues Event Set Queues Event Set Snoop Event Set Replay Event Set Stall Event Set Include idle --exclude-idle False Dcache Sysbus Event SetMetrics Available for Intel Itanium 9500 series systems 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 Index Symbols273 CPU event names shortening, 94 CPU events Daemon processes measuring Environment variables HP Caliper, 104 Error messages 275 Sampled measurements performing Useparensforstatementdata constant 277