NAME

prof − display profile data

SYNOPSIS

prof [ −a ] [ −l ] [ −n ] [ −s ] [ −v [ −low [ −high ] ] ] [ −z ] [ object-file [ profile-file ... ] ]

DESCRIPTION

Prof interprets the file produced by the monitor(3) subroutine.  In the default case, the symbol table in the named object file (object-file by default) is read and correlated with the profile file (profile-file 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 more than one profile file is specified, the output represents the sum of the profiles. 

To tally the number of calls to a routine, the program must be compiled with the −p option of cc, f77 or pc. This option also means that the profile file is produced automatically.

Beware of quantization errors. 

OPTIONS

−a Report all symbols rather than just external symbols. 

−l Sort the output by symbol value. 

−n sort the output by number of calls. 

−s Produce a summary profile file in mon.sum. This is really only useful when more than one profile file is specified.

−v [ −low [ −high ]]
Suppress all printing and produce a graphic version of the profile on the standard output for display by the plot(1G) filters.  When plotting, the numbers low and high, (by default 0 and 100), select a percentage of the profile to be plotted, with accordingly higher resolution. 

−z Print 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), cc(1V), plot(1G), gprof(1)

BUGS

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

Sun Release 3.2  —  Last change: 8 October 1984