NAME

prof − display profile data

SYNOPSIS

prof [ options ] [ −v [ −low [ −high ] ] ] [ a.out [ mon.out ...  ] ]

DESCRIPTION

Prof interprets the file produced by the monitor subroutine.  Under default modes, prof reads the symbol table in the named object file (a.out by default) and correlates it with the profile file (mon.out by default).  For each external symbol, the percentage of time spent executing between that symbol and the next is printed (in decreasing order), together with the number of times that routine was called and the number of milliseconds per call.  If you specify more than one profile file, the output represents the sum of the profiles. 

To tally the number of calls to a routine, specify the −p option of cc, f77, or pc when you compile the file containing the routine.  This option also arranges for the profile file to be produced automatically. 

OPTIONS

−a Reports all symbols, not just external symbols. 

−l Sorts the output by symbol value. 

−n Sorts the output by number of calls. 

−s Produces a summary profile file in mon.sum.  This is useful only when you specify more than one profile file. 

−v Suppresses all printing and produces a graphic version of the profile on the standard output for display by the plot(1) filters.  When plotting, the numbers low and high, by default 0 and 100, may be given to cause a selected percentage of the profile to be plotted with accordingly higher resolution. 

−z Prints in the ouput routines which have zero usage (as indicated by call counts and accumulated time). 

FILES

mon.outfor profile
a.outfor namelist
mon.sumfor summary profile

SEE ALSO

monitor(3), profil(2), cc(1), plot(1G)

BUGS

Beware of quantization errors. 

Prof is confused by f77, which puts the entry points at the bottom of subroutines and functions. 

4th Berkeley Distribution  —  April 29, 1985