Timing File

LoopReport also reads the timing file associated with your program. The timing file is created when you use the -zlp option, and contains information about loops. Typically, this file has a name of the format program.looptimes, and is found in the same directory as your program.

However, there are four ways to specify the location of a timing file. LoopReport chooses a timing file according to the rules listed below.

• If a timing file is named on the command line, LoopReport uses that file.

  ---

  % loopreport program newtimes > program.loopreport
  

  ---

• If the command-line option -p is used, LoopReport looks in the directory named by -p for a timing file.

  ---

  % loopreport program -p /home/timingfiles > program.loopreport
  

  ---

• If the environment variable LVPATH is set, LoopReport looks in that directory for a timing file.

  ---

  % setenv LVPATH /home/timingfiles
  % loopreport program > program.loopreport
  

  ---

• LoopReport writes the table of loop statistics to stdout--the standard output. You can also redirect the output to a file, or pipe it into another command:

  ---

  % loopreport program > program.loopreport
  % loopreport program | more
  

  ---

Figure 3-4 Sample Loop Report