Setting Up the Tutorial

The tutorial examples are meant to be run from your own workspace. This topic contains general instructions to prepare the example programs for execution, and lists the system requirements for running the example programs.

The example programs should be run when no other programs are running on the same computer. If there are other programs running, the example programs accumulate time waiting for the CPU. This time shows up in the performance metrics, and could be a source of confusion.

To set up the tutorial:

  1. Ensure that your PATH environment variable contains the SunTM Studio software directory (/opt/SUNWspro/bin for SolarisTM platforms, /opt/sun/sunstudio10/bin for Linux platforms.)

    If the software is not installed in /opt, ask your system administrator for the correct path to the software, and substitute this path for the default path wherever it occurs in this tutorial.

  2. Create a work directory to store the example programs and data.

    This directory should be local to the machine on which you intend to run the example programs, to minimize the distortion of the program performance when you collect performance data.

  3. Copy the files in one or more of the example subdirectories to your own work directory.

    The examples are stored in /opt/SUNWspro/examples/analyzer or /opt/sun/sunstudio10/examples/analyzer. Each example is in its own subdirectory. The example subdirectories are synprog, mttest, omptest and cachetest.

  4. Change to each of the example subdirectories in your work directory in turn and type make to compile and link the example program.

System Requirements

Some of the examples have specific hardware requirements.


Can't find what you are looking for? Submit your comments at http://www.sun.com/hwdocs/feedback.
Legal Notices