Scgprof Reports Require Kernel Patch | HP UX Caliper Software

On HP-UX, sampled call graph reports require kernel patch PHKL_34020.

To install this patch, check the HP IT Resource Center for availability and download information. Email the HP Caliper team at caliper-help@cup.hp.com if you have questions about this patch.

scgprof Reports Require Kernel Patch 167

Image 167

HP UX Caliper Software manual Scgprof Reports Require Kernel Patch

Contents

HP Caliper User Guide Copyright 2011 Hewlett-Packard Development Company, L.P Contents Remote GUI HP Caliper Measurement Configuration FilesHP Caliper Options Contents Threads Traps-reported User-regionsHP-UX only Version Using the HP Caliper AdvisorUsing the HP Caliper Advisor in the GUI Configuring HP Caliper HP Caliper Environment Variables 103 Controlling the Content of Reports 104Producing a Sampled Call Graph Profile Analysis 120 Producing a Sampled Call Stack Profile Analysis 132 Descriptions of Measurement Reports 168 HP Caliper Diagnostic and Warning Messages 164Limitations to Using cstack 149 Pstack like functionality Contents Event Set Descriptions for CPU Metrics HP-UX only 219 Glossary 253 Index 258 About This Document File name CommandTypographic Conventions Computer output 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 Compilers and Application Environments What Does HP Caliper Run On?Supported Hardware and Operating Systems 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 Precise Measurements Types of MeasurementsGlobal Measurement Sampled Measurements Measurement What to Look for in Using HP CaliperSyntax for caliper Command Caliper measurement caliperoptions program programarguments Showing HP Caliper Options Basic Tasks a Quick ReferenceStarting HP Caliper Stopping HP Caliper Creating a Report Based on Your Collected Data Using the HP Caliper AdvisorRestrictions on Using HP Caliper Creating a Text Report for Analysis Caliper report merge diff Additional HP Caliper CommandsGetting Information About HP Caliper Caliper info Window Basics What Is the HP Caliper GUI?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 Collect View Analyze View Analyze View Advisor View Advisor View Console View Help View Diagnostics View Making Measurements Tips for Using ViewsHints on How to Make Measurements Exploring Performance Data Getting Performance Tuning AdviceExploring Performance Data Remote GUI Getting HelpStarting the GUI Native Local GUI Starting the GUI Login Screen Measurement Configuration Files Provided with HP Caliper HP Caliper Measurement Configuration Files Icache DtlbEcount Fprof Global Sampled Overview MeasurementAvailable Measurements in Each Measurement Type Simultaneous fprof Sampling on Multiple PMU Counters Location of Measurement Configuration FilesSimultaneous fprof Sampling on Multiple PMU Counters See Hierarchy for Processing an Option Value p Specifying Option Values in Measurement Configuration FilesYou are free to rename measurement configuration files Examples HP Caliper OptionsBasic Information About Options Multiple Ways to Specify HP Caliper Option Values Examples Or --databaseOr --duration Hierarchy for Processing an Option Value Or --metrics Or --options-fileOr -? Or --help Cpuevent Or --output-file For PMU Histogram Reports Or --processOr --report-details Rate Or --sampling-specFor Function Coverage Reports Speriod Srate ,variation ,cpuevent Branchevent Default value is 5 percentOr --version CPUCYCLES,10000,10% Analysis-focus Advice-classesAdvice-cutoff Advice-details Callpath-cutoffpercentcutoff,cumpercentcutoff,mincount Bus-speedCallpath-cutoff Bus-speed int Cpu-details Context-linesCpu-aggregation Cpu-counter Dbrp Csv-fileDcache-data-profile Database Detail-cutoff Db-saveDescription-details Details Example Etb-freeze-delayDuration Etb-walkback-cycles integer Event-defaultsEvent-defaults privilege-level-mask=levelthreshold=int Etb-walkback-cycles Frame-depth Exclude-caliperExclude-idle Fold Info HelpHotpaths Ibrp Kernel-stack JoinJre Kernel-path Metrics Latency-bucketsMeasure-on-interrupts Memory-usage= Module-search-path Module-defaultModule-exclude Module-include Output-file NoinlinesOmr Options-file Prim-cutoff Per-module-dataPercent-columns Percent-sample Process-cutoffpercentcutoff,cumpercentcutoff,mincount ProcessProcess-cutoff See -p or --process p Rule-files Read-init-fileReport Report-details Psetid psetid Using --scope system for System-Wide Measurements Sort-bymetric,cpuevent SearchSkip-functions Sort-by Summary-cutoffpercentcutoff,cumpercentcutoff,mincount Source-path-mapStop-functions Summary-cutoff System-modelmodel-number,number-of-cells System-model Linux onlySystem-usage= Term-display User-regions ThreadsTraps-reported Version VersionSee -v or --version p Limitations to Keep in Mind Using the HP Caliper AdvisorWhat Is the HP Caliper Advisor? Example of an HP Caliper Advisor Report Example 1 HP Caliper Advisor Report Steps in Using the AdvisorSteps in Using the Advisor Where adviseoptions are Command Line to Invoke the AdvisorCommand line is Max-count Advice-classesAdvice-cutoff Advice-details 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 Suggestions for Using the HP Caliper Advisor Suggestions for Using the HP Caliper Advisor How the HP Caliper Advisor Works Making Performance Measurement Runs Using the HP Caliper Advisor in the GUIBasic Steps in Using the HP Caliper Advisor in the GUI Basic Steps in Using the HP Caliper Advisor in the GUI 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 Caliperinit file, you can then simply type Configuring HP CaliperExample of a .caliperinit File Suppressstatementdata = TrueFalse Setting Constants in the .caliperinit FileDisasmtargetnamelimit = limit Suppressinitwarnings = TrueFalse Shortening CPU Event Names Configuring Data CollectionConfiguring Data Collection Specifying Which CPU Events to Measure Module-exclude modulelist Module-default Module-include Module-excludeSpecifying Which Load Modules to Collect Data For Module-include modulelist How to Specify Load Module Names Default Settings for Load Module Data Collection For more information, see -s or --sampling-spec p Controlling Granularity of Data Collection and ReportsSpecifying Processes to Measure Process Tree Report Customfunctionname DefaultSyntax for -p Option Root-forks Someopt1,opt2,...pattern Using -p someSome opt1,... pattern Glob1 glob2 Reports information for cc root, cc fork, cc fork, ctcom Examples of the -p OptionProcess Origin Options Used with -p some To measure only ecom and ld Attaching to a Running Process to Perform Measurements Using HP Caliper in Your Build ProcessUsing HP Caliper in Testing and Quality Assurance Using HP Caliper to Generate Test Suite Reports Example Output of the caliper info Command Options for the caliper info Command Examples of the caliper info Command HP Caliper Environment Variables Layout of an HP Caliper Text or CSV Report Controlling the Content of ReportsControlling 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 Source Line Data Branch Targets in Disassembly ListingsSource Position Correlation Address Types Shown Unknown Functions How Functions Are Named in ReportsVSE Information Shown in Report Output Unnamed Functions Controlling the Content of Reports Or simply Changing the Default Name and LocationHow HP Caliper Saves Data in Databases Names and Locations for the Databases Caliper report merge diff reportoptions databases You can use the caliper report merge diff command toWhere reportoptions is one or more of these options Creating Reports from Multiple Databases Caliper merge reportoptions database1 database2 Databases is one of theseDatabase2 database1 for caliper diff Caliper report reportoptions database Cpucycles Example 2 Example of a caliper merge Run Caliper diff reportoptions database2 database1 Pmutrace Scgprof Example 3 Example of a caliper diff Run As cc1 Example of How to Use the caliper diff CommandCstack Pmutrace Scgprof As cc1 ld Producing a Sampled Call Graph Profile Analysis Producing a Sampled Call Graph Profile AnalysisHow Sampled Call Graph Profile Analysis Works Differences Between scgprof and cgprof Running the HP Caliper Sampled Call Graph Profile Running the HP Caliper Sampled Call Graph ProfileSampled Call Graph Text Report Example Caliper scgprof caliperoptions program programarguments 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 Hot Call Paths Part of the Report Sampled Call Graph Profile Report DetailsFlat Profile Part of the Report Call Graph 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 Caliper cstack caliperoptions program programarguments Producing a Sampled Call Stack Profile AnalysisRunning HP Caliper to Produce a Call Stack Profile Call Stack Profile Text Report Example for HP-UX 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 Call Stack Profile Report Details Call Stack Profile Report DetailsBlocking Primitives Summary Part of the Report Samples-running HP-UX only Samples-blocked HP-UX only Example 4 Sample cstack Report Blocking Primitives Details Sample report follows Limitations to Using cstackAvoids gprof Fallacy Pstack like functionality 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 Example Report Output How to Read the ReportsSystem Memory Configuration Table 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 Taking PMU Samples in Your Code Taking PMU Samples in Your CodeTriggering PMU Samples in Specific Code Regions Run ./myprog and find the process ID of the process 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 Instructions Labeled Stub HP Caliper Diagnostic and Warning MessagesError #28 Caliper Invalid Measurement Combination HP Caliper Diagnostic and Warning Messages Mispredicted Branches Mispredicted Branches Example Scgprof Reports Require Kernel Patch PMU Sample Hits Outside Function Range Scgprof Reports Require Kernel Patch Alat Measurement Report Description Example Command Line for Text ReportExample Command Line for CSV Report Descriptions of Measurement Reports Metrics for Integrity Servers Itanium 2 Systems Alat Metrics Summed for Entire Run INSTFAILEDCHKALDCALAT.FP Alat Measurement Report MetricsINSTCHKALDCALAT.FP INSTCHKALDCALAT.INT Information in alat Measurement Reports Branch Measurement Report DescriptionHow Alat Metrics Are Obtained Branch Metrics Summed for Entire Run BRMISPREDDETAIL.RETURN.WRONGPATH BRMISPREDDETAIL.NRETIND.WRONGPATHBRMISPREDDETAIL.NRETIND.WRONGTARGET BRMISPREDDETAIL.RETURN.CORRECTPRED Information in branch Measurement Reports Branch Measurement Report Metrics For rows showing instructions on a bundle boundary Cgprof Report DescriptionHow branch Metrics Are Obtained Available only on HP-UX Profiled otherwise blank HP Caliper Call Graph Profile Results AccuracyCall Graph Profile Metrics Information in cgprof Measurement Report Parent Listings This child entry Cpu Measurement Report DescriptionInformation in cgprof Measurement Report Children Listings Column Description Func Hits In Children CPU Event Sets Example Command Lines for Text Report L2cache DspecL1dcache L1icache Sysbus ThreadswitchCstack Measurement Report Description Cstack Measurement Report Metrics Semaphore, message queue, socket, pipe, file descriptor Be resolved to a symbolColumn Description Total Hits Waiting Message queue, socket, pipe, file descriptor Cycles Measurement Report Description Cycles Measurement Report DescriptionParent Func Hits Children Cycles Metrics Summed for Entire Run Information in cycles Measurement Reports Cycles Measurement Metrics How cycles Metrics Are Obtained From that bundle are split issuedDcache Measurement Report Description L1DREADMISSES.ALL Dcache Metrics Summed for Entire RunL1DREADS L2DMISSES DatareferencesL2DINSERTMISSES Cycles Object Avg. Dcache Dcache Measurement Report MetricsL2DREFERENCES.ALL Information in dcache Measurement Reports Example dcache Reports Dcache Measurement Report Description How Data Cache Metrics Are Obtained Dtlb Measurement Report Description Dtlb Measurement Report DescriptionHow Latency Bucket Metrics Are Obtained How the Data Summary Information Is Obtained L2DTLBMISSES / Datareferences Dtlb Metrics Summed for Entire RunL2DTLBMISSES Dtlbinsertshpw Cycles lost due to all stalls lower is better Dtlb Measurement Report Metrics Information in dtlb Measurement Reports How Data TLB Metrics Are ObtainedFunction Source statement Instruction Ecount Measurement Report Description Ecount Measurement Report DescriptionEcount Metrics Summed for Entire Run Cpucycles Descriptions of Measurement Reports Fcover Measurement Report Metrics Fcount Measurement Report DescriptionFcover Measurement Report Description Fcount Measurement Report Metrics Function Fprof Measurement Report DescriptionUnknown Source Files Directory Fprof Measurement Report Description Fprof Metrics Summed for Entire RunNumber of elapsed processor cycles Full pipe bubbles in main pipe Fprof Measurement Metrics Information in fprof Measurement Reports How fprof Metrics Are Obtained L2INSTDEMANDREADS Icache Measurement Report DescriptionIcache Metrics Summed for Entire Run L1IREADS L1IPREFETCHES Information in icache Measurement Reports Icache Measurement Report MetricsThat are misses How Instruction Cache Metrics Are Obtained Function Details ITLBMISSESFETCH.L2ITLB Itlb Measurement Report DescriptionItlb Metrics Summed for Entire Run ITLBMISSESFETCH.L1ITLB Itlb Measurement Report Description Itlb Measurement Report MetricsBELOSTBWDUETOFE.IMISS Information in itlb Measurement Reports Function Statement Cache line Pmutrace Measurement Report Description Pmutrace Measurement Report DescriptionScgprof Measurement Report Description How Instruction TLB Metrics Are Obtained Is profiled otherwise blank Scgprof Measurement Report Metrics Flat ProfileScgprof Measurement Report Metrics Call Graph Profile Scgprof Measurement Report Description Information in scgprof Measurement Report Parent Listings Traps Measurement Report Description Debug VfaultDarght Dbit Traps Metrics Summed for Entire Run Information in traps Measurement Reports Traps Measurement MetricsCycles lost due to RSE stalls How traps Metrics Are Obtained Include idle --exclude-idle False Event Set Descriptions for CPU MetricsBrpath Event Set Metrics Available from this Measurement Event Set Descriptions for CPU Metrics Brpred Event Set Brpred Event Set Iprel C2c Event Set Cpi Event Set Cpi Event Set Mips Pred-OffCPI Cpubus Event Set Cpubus Event SetAvailable only on Itanium 2 and dual-core Itanium 2 systems 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 L1icache Event Set L1icache Event SetNON RSE Misses per Kinst 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 Bril CPUBRL BIL Threadswitch Event SetBWL BRC 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 259 CPU event names shortening, 93 CPU eventsDaemon processes measuring Environment variables HP Caliper, 103 Error messages 261 Sampled measurements performing Useparensforstatementdata constant