SYNTAX

PerformReport [-a] -l filename [-m [filename]] [-n nn] [-p]

DESCRIPTION

The PerformReport tool generates a performance report, using both a program's link map file and its performance data file. This performance report contains a list of the top 50 procedures that are taking up most of your program's time (that is, those that have the largest number of possible hits).

INPUT

The PerformReport tool needs two input files: a link map file (-l) and a performance data file (-m). Both input files must be produced at link time: the link map file by using the Link tool's -l option, and the performance data file by linking with the PerformLib.o library.

Note
In addition to your program's link map, the link map file must also contain the appropriate {MPW}ROM map file, such as MacIIciROM.map.

Note also that the performance data file is produced only after the application or tool is executed.•

OUTPUT

Standard output.

ALIAS RESOLUTION

This command resolves Finder aliases in all input file specifications.

STATUS

PerformReport can return the following status codes:

PARAMETERS

None

OPTIONS

-a

Produces a listing of all procedures, in segment order. Normally PerformReport lists only a portion of the procedures, sorted by the number of possible hits.

-l filename

Reads the specified link map file.

-m [filename]

Reads the specified performance data file. If you do not specify a filename, PerformReport reads the file Perform.out.

-n nn

Lists the top nn procedures according to the number of possible hits. The default is 50.

-p

Writes progress and summary information to the diagnostic output.

EXAMPLES

The following script first appends the ROM map file to the link map file myMapFile. It then reads myMapFile and Perform.out and writes a performance report to the file myReport.

Catenate "{MPW}ROM.Maps:MacIIROM.map" >> myMapFile
PerformReport -l myMapFile > myReport