Modula-2 || Compiler & Tools || Library || Search Engine

Ulm's Modula-2 System:
mprof

NAME

mprof - display profile data for Modula-2 programs

SYNOPSIS

mprof [-t] [-c] [-n] [-h] [ file [ monitor-file ] ]

DESCRIPTION

Mprof interprets the file mon.out produced by the Monitor subroutine. The symbol tables in the named object file (a.out default) and in the corresponding reference files are read and correlated with the mon.out profile file. For each procedure, the percentage of time spent executing this routine is printed, together with the number of times that routine was called and the number of milliseconds per call.

In order for the number of calls to a routine to be tallied, the -p option of m2c must have been given when the file containing the procedure was compiled. This option also arranges the mon.out file to be produced automatically.

The mutually exclusive options t, c, and n determine the type for sorting of the output lines (no sorting by default):

-t: Sort by decreasing percentage of total time.
-c: Sort by decreasing number of calls.
-n: Sort lexically by module and procedure name.

The h option causes the heading normally printed to be suppressed. (This is useful if the report is to be processed further.)

ENVIRONMENT

MODPATH: MODPATH specifies a list of directories separated by colons. This path is used for the search of reference file archives named REF.
SRCPATH: This path is used on the search of reference files.

FILES

`mon.out`	for profile
`a.out`	for namelist
`*.r`	reference files
`REF`	archive with reference files
`/usr/local/lib/modula/REF`	archive with std reference files

BUGS

Beware of quantization errors.

Mprof has not yet been ported to the Solaris2.x/SPARCv8 platform.

Edited by: borchert, last change: 1997/02/24, revision: 1.2, converted to HTML: 1997/04/28