Step 8: Viewing Per Procedure Statistics for the Application...............................................................33
Step 9: Viewing Per Instruction Statistics.............................................................................................33
Step 10: Stopping the HPCPI Daemon..................................................................................................33
4 Using HPCPI..................................................................................................................35
Starting HPCPI......................................................................................................................................35
Setting Up the HPCPI Environment................................................................................................35
Selecting a Location for the HPCPI Database Directory.................................................................36
Setting the Default Database Directory Environment Variable (HPCPID)......................................36
Starting the hpcpid Daemon..........................................................................................................36
Startup Information for hpcpid ...............................................................................................36
Selecting Events to Monitor.............................................................................................................37
Commonly Used Event Sets.......................................................................................................38
Modifying the Event Interval Value...........................................................................................38
Event Duty Qualifier..................................................................................................................39
Running an Application for Analysis...................................................................................................40
Labeling Data...................................................................................................................................40
Controlling the Daemon with hpcpictl............................................................................................41
Flushing Data to Disk: hpcpictl flush.....................................................................................41
Stopping the Daemon: hpcpictl quit........................................................................................41
Starting a New Data Epoch: hpcpictl epoch.............................................................................41
Displaying HPCPI Status Information: hpcpictl show..............................................................41
Viewing Data with hpcpiprof, hpcpilist, and hpcpitopcounts..............................................43
Default Input Data...........................................................................................................................43
Flushing Data: hpcpictl flush..................................................................................................43
Viewing Per-Image Data: hpcpiprof.................................................................................................44
HPCPI Header.................................................................................................................................44
hpcpiprof Image Data Table........................................................................................................44
hpcpiprof Output with Multiple Events................................................................................45
Viewing Per-Procedure Data: hpcpiprof image_name..................................................................46
HPCPI Procedure Header...............................................................................................................46
hpcpiprof Procedure Data Table..................................................................................................46
Viewing Per-Instruction Data: hpcpilist procedure_name image_name................................47
hpcpilist Header.........................................................................................................................47
hpcpilist Data Table...................................................................................................................47
Interpreting hpcpilist Event Counts..........................................................................................48
Listing the Instructions with the Highest Event Counts: hpcpitopcounts......................................49
hpcpitopcounts Header..............................................................................................................49
hpcpitopcounts Data Table........................................................................................................49
Listing Instructions in an Image: hpcpitopcounts image_name..................................................50
Interpreting hpcpitopcounts Event Counts...............................................................................50
HPCPI Utility Options..........................................................................................................................51
Specifying an Alternate Database....................................................................................................51
Example......................................................................................................................................51
Specifying an Alternate Epoch........................................................................................................51
Example......................................................................................................................................51
Selecting Data by System.................................................................................................................51
Example......................................................................................................................................52
Specifying Events to Display...........................................................................................................52
Examples:...................................................................................................................................52
Selecting Data by Label...................................................................................................................52
Extracting Data for a Process from Shared Image Metrics........................................................52
Specifying an Alternate Sort Key....................................................................................................53
Example......................................................................................................................................53
4 Table of Contents
Commentaires sur ces manuels