Index

_hwc hardware counter experiments
_hwc Hardware Counter Experiments

_hwctime hardware counter experiments
_hwctime Hardware Counter Experiments

_RLD_LIST variable
Effects of ssrun

_SPEEDSHOP_CALIPER_POINT_SIG variable
Using Calipers
User Environment Variables
Setting Calipers with Signals

_SPEEDSHOP_DEBUG_NO_SIG_TRAPS variable
Expert-Mode Environment Variables

_SPEEDSHOP_DEBUG_NO_STACK_UNWIND variable
Expert-Mode Environment Variables

_SPEEDSHOP_EXPERIMENT_TYPE variable
Expert-Mode Environment Variables
Effects of ssrun

_SPEEDSHOP_FILE_BUFFER_LENGTH variab
Expert-Mode Environment Variables

_SPEEDSHOP_HWC_COUNTER_NUMBER
_hwc Hardware Counter Experiments

_SPEEDSHOP_HWC_COUNTER_NUMBER variable
User Environment Variables

_SPEEDSHOP_HWC_COUNTER_OVERFLOW
_hwc Hardware Counter Experiments

_SPEEDSHOP_HWC_COUNTER_OVERFLOW variable
User Environment Variables

_SPEEDSHOP_HWC_COUNTER_PROF_NUMBER num variable
User Environment Variables

_SPEEDSHOP_INIT_DEFERRED_SIGNAL variable
Expert-Mode Environment Variables

_SPEEDSHOP_INSTR_ARGS variable
User Environment Variables

_SPEEDSHOP_MARCHING_ORDERS variable
Expert-Mode Environment Variables
Effects of ssrun

_SPEEDSHOP_OUTPUT_DIRECTORY variable
User Environment Variables

_SPEEDSHOP_OUTPUT_FILENAME variable
User Environment Variables

_SPEEDSHOP_OUTPUT_NOCOMPRESS variable
User Environment Variables

_SPEEDSHOP_POLLPOINT_CALIPER_POINT environment variable
Using Calipers
Setting Time-Oriented Calipers

_SPEEDSHOP_POLLPOINT_CALIPER_POINT variable
User Environment Variables

_SPEEDSHOP_REUSE_FILE_DESCRIPTORS variable
User Environment Variables

_SPEEDSHOP_RLD variable
User Environment Variables

_SPEEDSHOP_SAMPLING_MODE variable
Expert-Mode Environment Variables

_SPEEDSHOP_SBRK_BUFFER_ADDR variable
User Environment Variables

_SPEEDSHOP_SBRK_BUFFER_LENGTH variable
User Environment Variables
Expert-Mode Environment Variables

_SPEEDSHOP_SHUTDOWN_SIG variable
Expert-Mode Environment Variables

_SPEEDSHOP_SILENT variable
User Environment Variables

_SPEEDSHOP_TARGET_FILE variable
Effects of ssrun

_SPEEDSHOP_TRACE_EXEC variable
Process Tracking Environment Variables

_SPEEDSHOP_TRACE_FORK variable
Process Tracking Environment Variables

_SPEEDSHOP_TRACE_FORK_TO_EXEC variable
Process Tracking Environment Variables

_SPEEDSHOP_TRACE_MPI_RANKS variable
Process Tracking Environment Variables

_SPEEDSHOP_TRACE_SPROC variable
Process Tracking Environment Variables

_SPEEDSHOP_TRACE_SYSTEM variable
Process Tracking Environment Variables

_SPEEDSHOP_VERBOSE variable
User Environment Variables

_SSMALLOC_NO_BUFFERING variable
User Environment Variables

API
setting calipers
Collecting Data for Part of a Program

basic block counting
inclusive
Inclusive Basic Block Counting
overview bbcounts experiment
overview
Experiment Types

bbcounts CPU time
How SpeedShop Calculates CPU Time for bbcounts Experiments

bbcounts experiment
effects
Effects of ssrun
tutorial experiments
bbcounts basic block counting
A Basic Block Experiment
A bbcounts Experiment

block counting
How SpeedShop Prepares Files

bugs
Sources of Performance Problems

butterfly option
Using the -butterfly Option

cache thrashing
Sources of Performance Problems

-calipers
Collecting Data for Part of a Program
automatic
Using Calipers
pollpoint
time oriented
Using Calipers
sample traps
using the debugger
Setting Calipers with a Debugger
sample traps calipers
Using Calipers
setting calipers
Using Calipers
time-oriented
Setting Time-Oriented Calipers

calipers option
Using the -calipers Option

calipers option to prof
Collecting Data for Part of a Program

commands in SpeedShop
Commands

compiler feedback files
Generating Compiler Feedback Files

compiler optimization restrictions
Building Your Executable

cord
Generating Compiler Feedback Files

CPU time calculations
How SpeedShop Calculates CPU Time for bbcounts Experiments

CPU-bound processes
Sources of Performance Problems

cy_hwc experiment
_hwc Hardware Counter Experiments

cy_hwctime experiment
_hwctime Hardware Counter Experiments

data display anomalies
Special Information for MP Fortran Programs

dc_hwc experiment
_hwc Hardware Counter Experiments

dc_hwctime experiment
_hwctime Hardware Counter Experiments

debugger
setting calipers
Collecting Data for Part of a Program
Using Calipers
Setting Calipers with a Debugger
using ssrun
Using ssrun with a Debugger

demo program SpeedShop
C and C++
Tutorial Overview

dsc_hwc experiment
_hwc Hardware Counter Experiments

dsc_hwctime experiment
_hwctime Hardware Counter Experiments

DSOs shared libraries
Supported Programming Models and Languages

environment variables
Using Run-Time Environment Variables
_RLD_LIST
Effects of ssrun
_SPEEDSHOP_CALIPER_POINT_SIG
Using Calipers
User Environment Variables
Setting Calipers with Signals
_SPEEDSHOP_DEBUG_NO_SIG_TRAPS
Expert-Mode Environment Variables
_SPEEDSHOP_DEBUG_NO_STACK_UNWIND
Expert-Mode Environment Variables
_SPEEDSHOP_EXPERIMENT_TYPE
Expert-Mode Environment Variables
Effects of ssrun
_SPEEDSHOP_FILE_BUFFER_LENGTH
Expert-Mode Environment Variables
_SPEEDSHOP_HWC_COUNTER_NUMBER
_hwc Hardware Counter Experiments
User Environment Variables
_SPEEDSHOP_HWC_COUNTER_OVERFLOW
_hwc Hardware Counter Experiments
User Environment Variables
_SPEEDSHOP_HWC_COUNTER_PROF_NUMBER num
User Environment Variables
_SPEEDSHOP_INIT_DEFERRED_SIG
Expert-Mode Environment Variables
_SPEEDSHOP_INSTR_ARGS
User Environment Variables
_SPEEDSHOP_MARCHING_ORDERS
Expert-Mode Environment Variables
Effects of ssrun
_SPEEDSHOP_OUTPUT_DIRECTORY
User Environment Variables
_SPEEDSHOP_OUTPUT_FILENAME
User Environment Variables
_SPEEDSHOP_OUTPUT_NOCOMPRESS
User Environment Variables
_SPEEDSHOP_POLLPOINT_CALIPER_POINT
User Environment Variables
Setting Time-Oriented Calipers
_SPEEDSHOP_REUSE_FILE_DESCRIPTORS
User Environment Variables
_SPEEDSHOP_RLD full_path_name
User Environment Variables
_SPEEDSHOP_SAMPLING_MODE
Expert-Mode Environment Variables
_SPEEDSHOP_SBRK_BUFFER_ADDR
User Environment Variables
_SPEEDSHOP_SBRK_BUFFER_LENGTH
User Environment Variables
Expert-Mode Environment Variables
_SPEEDSHOP_SHUTDOWN_SIG
Expert-Mode Environment Variables
_SPEEDSHOP_SILENT
User Environment Variables
_SPEEDSHOP_TRACE_EXEC [True|False]
Process Tracking Environment Variables
_SPEEDSHOP_TRACE_FORK
Process Tracking Environment Variables
_SPEEDSHOP_TRACE_FORK_TO_EXEC
Process Tracking Environment Variables
_SPEEDSHOP_TRACE_MPI_RANKS
Process Tracking Environment Variables
_SPEEDSHOP_TRACE_SPROC
Process Tracking Environment Variables
_SPEEDSHOP_TRACE_SYSTEM
Process Tracking Environment Variables
_SPEEDSHOP_VERBOSE
User Environment Variables
_SSMALLOC_NO_BUFFERING
User Environment Variables

examples
c tutorial
Tutorial for C Users
fortran tutorial
Tutorial for Fortran Users

exec system call
Supported Programming Models and Languages

executable requirements
calipers
Building Your Executable

executables
calculating a working set
Calculating the Working Set of a Program

execution times
How SpeedShop Calculates CPU Time for bbcounts Experiments

experiment data
controlling output file
Setting Up Output Directories and Files
file name examples
Setting Up Output Directories and Files

experiment data files
combining
Combining Multiple Experiment Files into One
performance data
Gathering and Analyzing Performance Data

experiment types
Experiment Types

experiments
cy_hwc
_hwc Hardware Counter Experiments
dc_hwc
_hwc Hardware Counter Experiments
dsc_hwc
_hwc Hardware Counter Experiments
fpe, trace floating-point exceptions
Floating-Point Exception Trace Experiment (fpe)
gfp_hwc
_hwc Hardware Counter Experiments
_hwc Hardware Counter Experiments
hardware counter
Hardware Counter Experiments (*_hwc, *_hwctime)
Hardware Counter Experiment Reports
heap trace
Heap Trace Experiment (heap)
I/O trace
I/O Trace Experiment (io)
isc_hwc
_hwc Hardware Counter Experiments
pcsamp
PC Sampling Experiment (pcsamp)
pcsamp and bbcounts
Using pcsamp and bbcounts Together
prof_hwc
_hwc Hardware Counter Experiments
selecting
Selecting an Experiment
ssrun setup
Building Your Executable
tlb_hwc
_hwc Hardware Counter Experiments
totaltime
Experiment Types
types of
Experiment Types
usertime
Call Stack Profiling Experiment (usertime/totaltime)

file preparation
How SpeedShop Prepares Files

floating-point exception trace
experiment description
Floating-Point Exception Trace Experiment (fpe)
overview
Experiment Types

fork processes
Supported Programming Models and Languages

Fortran
files for tutorial
Tutorial for Fortran Users
limitations, multiprocessor executables
Special Information for MP Fortran Programs

Fortran tutorial
Tutorial for Fortran Users

fpcsampx
PC Sampling Experiment (pcsamp)

fpe trace experiment
Floating-Point Exception Trace Experiment (fpe)
tutorial experiments
fpe trace floating-point exceptions
An fpe Trace

fsc_hwc experiment
_hwc Hardware Counter Experiments

fsc_hwctime experiment
_hwctime Hardware Counter Experiments

gfp_hwc experiment
_hwc Hardware Counter Experiments

gfp_hwctime experiment
_hwctime Hardware Counter Experiments

gi_hwc experiment
_hwc Hardware Counter Experiments

gi_hwctime experiment
_hwctime Hardware Counter Experiments

hardware counter experiment reports
Hardware Counter Experiment Reports

hardware counter experiments
_hwc
_hwc Hardware Counter Experiments
_hwctime
_hwctime Hardware Counter Experiments
cy_hwc
_hwc Hardware Counter Experiments
cy_hwctime
_hwctime Hardware Counter Experiments
dc_hwc
_hwc Hardware Counter Experiments
dc_hwctime
_hwctime Hardware Counter Experiments
dsc_hwc
_hwc Hardware Counter Experiments
dsc_hwctime
_hwctime Hardware Counter Experiments
fsc_hwctime
_hwctime Hardware Counter Experiments
gfp_hwc
_hwc Hardware Counter Experiments
_hwc Hardware Counter Experiments
gfp_hwctime
_hwctime Hardware Counter Experiments
gi_hwc
_hwc Hardware Counter Experiments
gi_hwctime
_hwctime Hardware Counter Experiments
ic_hwc
_hwc Hardware Counter Experiments
ic_hwctime
_hwctime Hardware Counter Experiments
introduction
Hardware Counter Experiments (*_hwc, *_hwctime)
isc_hwc
_hwc Hardware Counter Experiments
isc_hwctime
_hwctime Hardware Counter Experiments
prof_hwc
_hwc Hardware Counter Experiments
prof_hwctime
_hwctime Hardware Counter Experiments
tlb_hwc
_hwc Hardware Counter Experiments
tlb_hwctime
_hwctime Hardware Counter Experiments
tutorial experiments
A Hardware Counter Experiment
A Hardware Counter Experiment

hardware counter numbers
Hardware Counter Numbers

hardware counter tools
Two Tools for Hardware Counter Experiments

heap trace
Heap Trace Experiment (heap)

ic_hwc experiment
_hwc Hardware Counter Experiments

ic_hwctime experiment
_hwctime Hardware Counter Experiments

inclusive basic block counting
Inclusive Basic Block Counting

introduction to performance analysis
Introduction to Performance Analysis

I/O trace experiment
I/O Trace Experiment (io)

I/O-bound processes
Sources of Performance Problems

isc_hwc experiment
_hwc Hardware Counter Experiments

isc_hwctime experiment
_hwctime Hardware Counter Experiments

libfpe_ss.so
overview
SpeedShop Libraries

libmalloc.so
overview
SpeedShop Libraries

libpixrt.so
overview
SpeedShop Libraries

libraries
libssrt.so
Effects of ssrun
libss.so
Effects of ssrun
linking in SpeedShop
Setting Calipers with the ssrt_caliper_point Function
overview
SpeedShop Libraries

libssrt.so
overview
SpeedShop Libraries

libss.so
SpeedShop Libraries

machine resource usage
Collecting Data on Machine Resource Usage

marching orders
Using Marching Orders
experiment specifier
Defining the Base Experiment

memory
locking
Using the squeeze Command

memory-bound processes
Sources of Performance Problems

MP Fortran limitations
Special Information for MP Fortran Programs

MPI
with ssrun
Running Experiments on MPI Programs

MPI message-passing paradigms
Supported Programming Models and Languages

multiprocessor executables
Supported Programming Models and Languages
profiling
Generating Reports for Multiprocessed Executables

OpenMP
and ssrun
Running Experiments on Programs That Use OpenMP Directives

OpenMP support
Supported Programming Models and Languages

pc sampling
pcsamp experiment
overview
Experiment Types

pcsamp experiment
A pcsamp Experiment
example
Example Using the pcsampx Experiment
PC sampling program
PC Sampling Experiment (pcsamp)
tutorial experiments
PC sampling tutorial
A pcsamp Experiment

perfex
Two Tools for Hardware Counter Experiments

performance analysis
Sources of Performance Problems
introduction
Introduction to Performance Analysis
phases
Using SpeedShop Tools for Performance Analysis

performance problems
bugs
Sources of Performance Problems
cache thrashing
Sources of Performance Problems
CPU-bound processes
Sources of Performance Problems
I/O--bound processes
Sources of Performance Problems
memory-bound processes
Sources of Performance Problems
program phases
Sources of Performance Problems

prof
-butterfly example profiling
inclusive basic block counts
bbcounts Experiment Reports
options
prof Options
output
prof Output
overview
Commands
-S example
Using the -S Option
syntax
prof Arguments
using with ssrun
Using prof to Generate Performance Reports

prof command
butterfly option
Using the -butterfly Option
calipers option
Using the -calipers Option

prof_hwc experiment
_hwc Hardware Counter Experiments

prof_hwctime experiment
_hwctime Hardware Counter Experiments

profiling
bbcounts experiment experiments
bbcounts bbcounts experiment reports
bbcounts Experiment Reports
-clock option
prof Options
-dis option
prof Options
-dis option prof
-dis example
Using the -dis Option
-dsolist option
prof Options
-exclude option
prof Options
-feedback option
prof Options
fpe trace experiment experiments
fpe fpe trace experiment reports
fpe Trace Reports
-fpe_type option
prof Options
hardware counter experiments
Hardware Counter Experiment Reports
-heavy option
prof Options
-lines option
prof Options
machine scheduler option reports
for different machine models
Generating Reports for Different Machine Types
-only option
prof Options
pcsamp experiment experiments
pcsamp pcsamp experiment reports
pcsamp Experiment Reports
processor scheduler option option
prof Options
-quit option
prof Options
-S option
prof Options
Using the -S Option
usertime experiment experiments
usertime usertime experiment reports
usertime Experiment Reports

program overhead
Determining Program Overhead

program phases
Sources of Performance Problems

pthreads
Supported Programming Models and Languages
and ssrun
Running Experiments on Programs Using Pthreads

rearranging procedures
Generating Compiler Feedback Files

reordering code regions
Basic Block Counting Experiment (bbcounts)

run-time environment variables
Using Run-Time Environment Variables

setup ssrun
Building Your Executable

signals
setting calipers
Collecting Data for Part of a Program
Setting Calipers with Signals

SpeedShop
overview
SpeedShop Tools

speedshop api
API

SpeedShop demo
Fortran
Tutorial Overview

SpeedShop hardware counter experiments
introduction
Hardware Counter Experiments (*_hwc, *_hwctime)

SpeedShop libraries
Effects of ssrun
libss.so libraries
SpeedShop Libraries
linking libss.so
Setting Calipers with the ssrt_caliper_point Function

sproc system call
Supported Programming Models and Languages

squeeze
calculating a working set
Calculating the Working Set of a Program
locking memory
Using the squeeze Command
overview
Commands

sscompare
Gathering and Analyzing Performance Data
overview
Commands

ssrt_caliper_point
API
Building Your Executable

ssrt_caliper_point calipers
Using Calipers
Setting Calipers with the ssrt_caliper_point Function

ssrun
and OpenMP
Running Experiments on Programs That Use OpenMP Directives
effects
Effects of ssrun
flags
ssrun Syntax
MPI programs
Running Experiments on MPI Programs
overview
Commands
overview ssrun
steps prof
Gathering and Analyzing Performance Data
pthreads programs
Running Experiments on Programs Using Pthreads
syntax
ssrun Syntax
using a debugger
Using ssrun with a Debugger
-v option example
Example Using the -v Option

ssrun command
examples
ssrun Examples
syntax
ssrun Syntax

ssrun setup
Building Your Executable

ssusage
calculating a working set
Calculating the Working Set of a Program
machine resource usage
ssusage Results
overview
Commands

statistical call stack profiling
overview usertime experiment
overview
Experiment Types

statistical hardware counter sampling
overview hardware counter experiments
overview hwc experiments
Experiment Types

stripped executables programs
Building Your Executable

system call
Supported Programming Models and Languages

thrash
calculating a working set
Calculating the Working Set of a Program
overview
Commands

thrash paging behavior
Using the thrash Command

tlb_hwc experiment
_hwc Hardware Counter Experiments

tlb_hwctime experiment
_hwctime Hardware Counter Experiments

totaltime experiment
Experiment Types
totaltime call stack profiling
Call Stack Profiling Experiment (usertime/totaltime)

Tutorial
c
Tutorial for C Users

tutorial experiments
PC sampling
A pcsamp Experiment

user environment variables
User Environment Variables

usertime experiment
restrictions
Building Your Executable
tutorial experiments
call stack profiling
A usertime Experiment
usertime call stack profiling
A usertime Experiment
usertime call stack profiling
Call Stack Profiling Experiment (usertime/totaltime)

working set
Calculating the Working Set of a Program