1PROF(1)                     General Commands Manual                    PROF(1)
2
3
4

NAME

6       prof - display profile data
7

SYNOPSIS

9       prof  [  -a  ]  [ -l ] [ -n ] [ -z ] [ -s ] [ -v [ -low [ -high ] ] ] [
10       a.out [ mon.out ... ] ]
11

DESCRIPTION

13       Prof interprets the file produced by  the  monitor  subroutine.   Under
14       default  modes,  the  symbol  table  in  the  named  object file (a.out
15       default)  is  read  and  correlated  with  the  profile  file  (mon.out
16       default).   For each external symbol, the percentage of time spent exe‐
17       cuting between that symbol and  the  next  is  printed  (in  decreasing
18       order),  together  with the number of times that routine was called and
19       the number of milliseconds per call.  If more than one profile file  is
20       specified, the output represents the sum of the profiles.
21
22       In  order  for  the  number of calls to a routine to be tallied, the -p
23       option of cc, f77 or pc must have been given when the  file  containing
24       the  routine  was  compiled.  This option also arranges for the profile
25       file to be produced automatically.
26
27       Options are:
28
29       -a     all symbols are reported rather than just external symbols.
30
31       -l     the output is sorted by symbol value.
32
33       -n     the output is sorted by number of calls
34
35       -s     a summary profile file is produced in mon.sum.  This  is  really
36              only useful when more than one profile file is specified.
37
38       -v     all  printing is suppressed and a graphic version of the profile
39              is produced on the standard output for display  by  the  plot(1)
40              filters.   When plotting, the numbers low and high, by default 0
41              and 100, may be given to cause a selected percentage of the pro‐
42              file to be plotted with accordingly higher resolution.
43
44       -z     routines  which have zero usage (as indicated by call counts and
45              accumulated time) are nevertheless printed in the output.
46

FILES

48       mon.out  for profile
49       a.out    for namelist
50       mon.sum  for summary profile
51

SEE ALSO

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

BUGS

56       Beware of quantization errors.
57
58       Is confused by f77 which puts the entry points at the bottom of subrou‐
59       tines and functions.
60
61
62
634th Berkeley Distribution       April 29, 1985                         PROF(1)