About This Guide

The SpeedShop User's Guide describes and illustrates methods for measuring program performance using SpeedShop commands such as ssrun and prof. It also contains tutorials that generate performance statistics for C and Fortran programs.

The SpeedShop performance tools described in this manual can help you to identify specific performance problems. The techniques described in this manual are only a part of performance tuning. Other areas that you can tune, but that are outside the scope of this document, include graphics, I/O, the kernel, system parameters, memory, and real-time system calls.

This book is intended for experienced programmers and others who are interested in optimizing program performance.

The following chapters are included in this book:

Related Publications

The following documents contain additional information that may be helpful:

  • Guide to SGI Compilers and Compiling Tools

  • C Language Reference Manual

  • MIPSpro C++ Programmer's Guide

  • ProDev WorkShop: Debugger User's Guide

  • ProDev WorkShop: Performance Analyzer User's Guide

  • ProDev WorkShop: Overview

  • ProDev WorkShop: Static Analyzer User's Guide

  • ProDev WorkShop: ProMP User's Guide

  • MIPSpro Fortran 77 Programmer's Guide

  • MIPSpro Fortran 77 Language Reference Manual

  • MIPSpro Fortran Language Reference Manual, Volume 1

  • MIPSpro Fortran Language Reference Manual, Volume 2

  • MIPSpro Fortran Language Reference Manual, Volume 3

  • MIPSpro Fortran 90 Commands and Directives Reference Manual

  • MIPSpro N32/64 Compiling and Performance Tuning Guide

  • Origin 2000 and Onyx2 Performance Tuning and Optimization Guide

  • MPI Programmer's Manual

In addition to these document, several man pages are available that detail SpeedShop and how it works. The following is a partial list of man pages:

  • intro_ss(1) is a 'quick reference' to the SpeedShop product.

  • speedshop(1) describes the experiments you can run and the reports generated by SpeedShop.

  • ss_caveats(5) describes some of the caveats encountered while using SpeedShop.

  • ss_environ(5) describes environment variables used with SpeedShop.

Obtaining Publications

To obtain SGI documentation, go to the SGI Technical Publications Library at http://docs.sgi.com.


The following conventions are used throughout this document:




This fixed-space font denotes literal items such as commands, files, routines, path names, signals, messages, and programming language structures.


Italic typeface denotes variable entries and words or concepts being defined.

user input 

This bold, fixed-space font denotes literal items that the user enters in interactive sessions. (Output is shown in nonbold, fixed-space font.)

[ ] 

Brackets enclose optional portions of a command or directive line.


Ellipses indicate that a preceding element can be repeated.


This font denotes the names of graphical user interface (GUI) elements such as windows, screens, dialog boxes, menus, toolbars, icons, buttons, boxes, fields, and lists.

Reader Comments

If you have comments about the technical accuracy, content, or organization of this document, please tell us. Be sure to include the title and document number of the manual with your comments. (Online, the document number is located in the front matter of the manual. In printed manuals, the document number is located at the bottom of each page.)

You can contact us in any of the following ways:

  • Send e-mail to the following address:

    [email protected]

  • Use the Feedback option on the Technical Publications Library World Wide Web page:


  • Contact your customer service representative and ask that an incident be filed in the SGI incident tracking system.

  • Send mail to the following address:

    Technical Publications
    1600 Amphitheatre Pkwy., M/S 535
    Mountain View, California 94043-1351

  • Send a fax to the attention of “Technical Publications” at +1 650 932 0801.

We value your comments and will respond to them promptly.